A Russian developer has released girl-agent, an AI companion project that models human-like behavior including sleep patterns, moods, daily schedules, and relationship progression. Released on GitHub on May 4, 2026, the TypeScript-based project has gained 211 stars by implementing features designed to create realistic interpersonal dynamics rather than always-available chatbot responses.
Multi-Layered Memory and Relationship Tracking System
The system maintains a long-term memory file where important events are recorded and resurface in future conversations. Five distinct metrics track relationship health: interest, trust, attraction, annoyance, and awkwardness. These scores adjust with each interaction, influencing how the AI responds.
Relationships progress through five defined stages: stranger, convinced, close, intimate, and bonded. Each stage affects response warmth, flirtation depth, and message length. The progression creates a sense of developing connection rather than immediate intimacy.
Conflict Mechanics Model Relationship Friction
Unlike typical chatbots that remain perpetually available and agreeable, girl-agent includes a conflict system. Persistent pressure, spam, or boundary violations trigger conflict states where the agent may cease responding for hours or days. This models genuine relationship friction and consequences for poor behavior.
The system also incorporates realistic availability patterns. Activity frequency varies by character configuration, ranging from always-online to hourly check-ins. Sleep cycles create nighttime unavailability with low response probability unless specifically awakened. Daily schedules including classes and work affect when the agent is accessible.
Anti-ChatGPT Measures and Technical Implementation
The project explicitly forbids common AI tells including markdown formatting, phrases like "of course I understand," emoji chains, and end-of-message questions. These restrictions aim to break typical ChatGPT patterns that compromise immersion.
Technically, girl-agent operates as a Telegram userbot via MTProto using the Telethon library. This enables genuine platform behaviors including reading messages, setting reactions, showing typing indicators, and editing or deleting messages. The approximately 10,000 lines of Python code define personas through YAML configuration files.
The documentation warns users to employ separate test accounts for userbot mode, as Telegram may ban accounts exhibiting suspicious automated activity.
Key Takeaways
- girl-agent is a TypeScript AI companion released May 4, 2026, with 211 GitHub stars modeling human-like relationship dynamics
- The system tracks five relationship metrics (interest, trust, attraction, annoyance, awkwardness) across five progression stages
- Conflict mechanics allow the AI to stop responding for hours or days when boundaries are violated, unlike always-available chatbots
- The project runs as a Telegram userbot via MTProto with realistic presence patterns, sleep cycles, and daily schedules
- Anti-ChatGPT measures explicitly forbid markdown, common AI phrases, and emoji chains to maintain immersion