Russian developer TheSashaDev has released Girl-agent, an open-source AI personality system that simulates realistic human behavior within Telegram. Published on GitHub on May 4, 2026, the project has garnered 168 stars and represents a departure from traditional chatbots by maintaining persistent state and emotional patterns rather than simply responding to messages.
Girl-Agent Functions as a Stateful Character, Not a Traditional Chatbot
Unlike conventional AI assistants, Girl-agent operates as a Telegram userbot via MTProto using the Telethon library. The system can read messages, add reactions, type, delete and edit content, making it appear as a real person rather than an automated bot. The implementation includes an anti-AI prompt specifically designed to remove ChatGPT-like behaviors, creating more natural conversation patterns.
The AI persona maintains continuous state through several sophisticated features:
- 4-layer memory architecture for conversation context
- Sleep cycles and daily schedules
- Mood simulation and emotional states
- Relationship stages that evolve over time
- Conflict simulation for realistic interactions
- Persona configuration in YAML format
The entire system comprises approximately 10,000 lines of Python code.
Users Must Navigate Telegram's Terms of Service Gray Area
The project operates in userbot mode, which exists in a gray area of Telegram's terms of service. Developers advise users to employ a separate test account rather than their main Telegram account, as the platform may ban accounts exhibiting suspicious activity associated with userbot behavior. This technical limitation reflects the challenge of creating AI systems that simulate human behavior within platforms not designed for such applications.
Project Distinguishes Itself Through Persistent Personality Traits
Girl-agent's architecture focuses on creating a character with state rather than a reactive conversational interface. The system simulates daily rhythms and emotional patterns, maintaining personality consistency across interactions. The GitHub repository description (in Russian) emphasizes these human-like qualities: "ИИ-девушка с человеческим поведением: сон, настроение, расписание, память, стадии отношений и конфликты."
The open-source nature of the project allows developers to examine and modify the persona configuration, memory systems, and behavioral patterns to create customized AI personalities for various use cases.
Key Takeaways
- Girl-agent is an open-source AI personality system that simulates human behavior including sleep cycles, moods, schedules, and relationship stages within Telegram
- The system operates as a Telegram userbot via MTProto using approximately 10,000 lines of Python code with a 4-layer memory architecture
- Unlike traditional chatbots, Girl-agent maintains continuous state and personality traits rather than simply responding reactively to messages
- Users must employ separate test accounts due to Telegram's potential to ban accounts for userbot activity, which operates in a gray area of the platform's terms of service
- The project has gained 168 stars on GitHub since its May 4, 2026 release by developer TheSashaDev