thesashadev/girl-agent

girl-agent is an engine for running an AI character on Telegram that is meant to feel like a real person rather than a chatbot. The README, which is in Russian, calls out the difference upfront. The persona sleeps at night, has a daily schedule, sometimes reads a message and stays silent, sometimes only puts a reaction, sometimes replies an hour later because she was busy. That delayed and patchy behaviour is presented as the intended design, not a bug. What sits behind that behaviour is a stack of layers rather than a single system prompt. The README enumerates them in a table. A presence layer decides how often she is online at all. A sleep layer turns her off overnight, with a :wake command that has a low chance of getting through. A daily-life layer gives each day a schedule of classes, work, commute, and free time, and the phone is unreachable during classes. A relationship layer keeps five counters: interest, trust, affection, irritation, and a cringe tolerance, all moving from message to message. A stages layer steps through nine levels of closeness, from cold first contact to long-term partner, and that stage affects warmth, flirting, and reply length. A conflict layer fires if the user pushes too hard or breaks boundaries, and she can go quiet for hours or days. A memory layer writes important events to a long-term.md file that resurfaces in later conversations. An anti-AI prompt blocks markdown, the word equivalent of certainly, emoji rows, and trailing questions, all the tells that give ChatGPT away. A userbot mode runs as a real Telegram account over MTProto, so it reads, reacts, types, edits, and deletes like a human user. An agenda layer schedules proactive messages such as wishing luck before an interview or following up on a meeting. Installation is offered three ways. On Linux, macOS, or WSL a single curl piped to sh installs an isolated Node 22 runtime under ~/.local without sudo, or uses Docker if it is present. On Windows the recommended path is to install Node 22 and run npx @thesashadev/girl-agent, which boots a WebUI on localhost port 3000. For servers there are docker run examples for interactive setup and headless mode, plus generators for a config file, a systemd unit, and Dockerfile or compose snippets. A separate native desktop client written in Rust ships in the Releases page for users who want a tray icon and autostart. The license is source-available rather than fully open source.