TheSashaDev

TheSashaDev / girl-agent

Public

ИИ-девушка с человеческим поведением: сон, настроение, расписание, память, стадии отношений и конфликты. Userbot mode через MTProto — реагирует, печатает, ставит реакции. Anti-AI промпт убирает ChatGPT-повадки. Не чат-бот — персонаж с состоянием.

44
5
69% credibility
Found May 05, 2026 at 44 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

girl-agent is an open-source AI Telegram chatbot simulating a realistic teenage girl's messaging behavior, complete with sleep cycles, daily schedules, mood tracking, long-term memory, and anti-AI detection to mimic human-like responses.

How It Works

1
🔍 Discover girl-agent

You hear about a fun app that creates a lifelike AI girl who chats in Telegram like a real person, with her own moods, sleep, and daily life.

2
🚀 Start the easy wizard

Run the simple starter tool, and it guides you with friendly questions to set everything up without hassle.

3
💬 Connect Telegram and AI

Link your Telegram chat and pick a smart thinking service so she can respond naturally—just share a few details like name and age.

4
🎨 Shape her personality

Add notes on her vibe, like shy or chatty, and choose her sleep times or daily routine to make her feel unique.

5
✨ Launch your companion

Hit go, and she springs to life in your Telegram, ready to chat with realistic delays, reactions, and memories.

6
💕 Enjoy real chats

Message her anytime—she might reply quick, ignore if busy or sleepy, share her day, or even plan follow-ups.

😍 Lifelike friendship

You now have a believable AI friend who evolves with your talks, building trust, moods, and stories over time.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 44 to 44 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is girl-agent?

girl-agent runs a Telegram userbot simulating an AI girlfriend with human behaviors like sleep cycles, daily schedules, mood swings, long-term memory, relationship stages, and conflicts. It uses MTProto for natural interactions—reading messages, typing indicators, reactions—while an anti-AI prompt strips ChatGPT tells like "of course" or markdown. Built in TypeScript, it creates a stateful character, not a stateless chatbot, deployable via npx or locally.

Why is it gaining traction?

Unlike basic tg userbot github clones (pyrogram userbot github, telethon userbot github) or prompt-only GPTs, it layers presence patterns, hormone cycles, agenda planning, and conflict escalation for realism that fools humans. No more always-online bots; she ignores during class or sleep, proactively pings about your plans, and evolves relationships organically. Stands out from Character.AI (web-only) or HeatherBot (NSFW-heavy Python) with Telegram-native userbot mode and anti-detection.

Who should use this?

AI agent hobbyists prototyping realistic companions, Telegram devs exploring github userbot telegram integrations, or researchers testing human-AI interaction (think girl agent anime sims or agent movie girl dynamics). Ideal for heroku userbot github deploys or local tinkering with custom personas via wizard CLI.

Verdict

Worth forking for AI agent experiments—solid TypeScript core, intuitive CLI (:status, :reset, :why), but beta with 44 stars and 0.7% credibility score signals early-stage risks like occasional LLM flubs. Polish docs and add tests to scale; great tinkering base today.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.