Girl Agent

This project is an open source companion agent that lives inside a Telegram chat. Rather than an assistant that answers on demand, it simulates a person with a body clock and a mood: it sleeps at night, replies curtly under stress, warms at other points of a simulated cycle, and is free to decline to reply at all. The stated goal is presence rather than intelligence. Four systems drive the behavior. A hormonal model runs Gaussian curves for estrogen, progesterone, luteinizing hormone, cortisol and oxytocin across an individual cycle, shaping tone without ever being shown to the language model directly. A sleep model gives each profile a presence pattern, with a wake command required before a set hour. A speech filter blacklists around forty markers of machine written text, enforcing lowercase, no markdown and no assistant phrasing. Memory is plain markdown on disk, split into persona, speech, long term memory and daily logs, so it stays human readable and editable with no vector database involved. Relationships advance through eight defined stages, from a first meeting to a long established couple. The code is free and open source, distributed as a single TypeScript repository that runs through tsx with no backend and no Docker. Installation is a clone, an npm install and a setup wizard that asks which model provider to use, with Anthropic, OpenAI, Groq, OpenRouter and ClaudeHub supported. There are no paid plans or hosted tiers, so running costs are whatever the chosen model provider charges. The site and documentation are written in Russian.