Summary

Girl-agent creates a stateful, human-like AI persona within Telegram, addressing the limitations of stateless chatbots. It targets users seeking realistic AI companions and developers interested in persistent AI agents. The benefit is an AI character with a simulated inner life—including sleep, mood, schedules, memory, and evolving relationships—offering dynamic, non-robotic interactions.

How It Works

This project uses a multi-layered state engine, not just a prompt. It simulates human presence, sleep, and daily schedules to control availability. Relationship dynamics are tracked via scores (interest, trust, etc.) and stages, influencing interaction style. Conflict resolution and long-term memory (via long-term.md) add depth. Operating via Telegram's MTProto (Userbot mode), it mimics human actions like typing and reacting. An "Anti-AI" prompt strips generic chatbot tells, enhancing realism.

Quick Start & Requirements

• Linux/macOS/WSL: sh curl -fsSL https://raw.githubusercontent.com/TheSashaDev/girl-agent/master/scripts/install.sh | sh, then girl-agent. Installs locally or via Docker.
• Windows: Requires Rust/Cargo; use cd desktop-rs && cargo run -p girl-agent-installer.
• Node.js (>= 20): npx @thesashadev/girl-agent.
• Docker: docker run -it --rm -v girl-agent-data:/data ghcr.io/thesashadev/girl-agent:latest. Headless/server modes require config files (bot.json) or env vars. A Telegram test account is recommended.

Highlighted Details

• Simulated Presence & Schedule: Mimics human availability, sleep, and daily activities.
• Evolving Relationships: Tracks scores and stages, dynamically altering persona and interaction.
• Long-Term Memory: Stores key events for contextual recall.
• Anti-AI Prompting: Avoids generic AI responses and artifacts.

Maintenance & Community

Currently in beta, under active development by TheSashaDev (TG: @voided_net). Community support via Telegram channel (https://t.me/GirlAgentAI/) and chat (https://t.me/GirlAgentAI_chat/). Bug reports via GitHub Issues.

Licensing & Compatibility

"Source-available" license permits personal use, study, and contributions. Commercial use, paid hosting, resale, and public competing clones are prohibited without explicit written permission.

Limitations & Caveats

Beta status implies potential instability. The restrictive license blocks commercial adoption. Userbot mode carries a risk of Telegram account bans. Windows and server setups require additional dependencies and configuration.