girl-agent is a TypeScript project presenting an AI-powered Telegram agent with layered state, memory, and userbot capabilities; it includes quick-start setup and Docker options. The repo shows 331 stars, 47 forks, and 5 open issues. No license listed in the facts.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (2 so far).
What it is
girl-agent is an AI agent for Telegram with layers such as Presence, Sleep, Daily-life, Relationship stages, Memory, Anti-AI, Userbot mode, and Agenda. It is described as an engine of an AI persona with its own state rather than a simple prompt.
How it works
The agent behavior is built from multiple layers (Presence, Sleep, Daily-life, Relationship, Memory, Anti-AI, Userbot mode, Agenda) rather than a single system prompt. It supports a Telegram userbot via MTProto and features memory stored in long-term storage and a conflict system.
Getting started
Linux / macOS / WSL — one command
curl -fsSL https://raw.githubusercontent.com/TheSashaDev/girl-agent/master/scripts/install.sh | sh
Дальше:
girl-agent
girl-agent --profile=arina
girl-agent server --help
Опции установщика:
curl -fsSL .../install.sh | sh -s -- --docker
curl -fsSL .../install.sh | sh -s -- --local
curl -fsSL .../install.sh | sh -s -- --version=0.4.1
Удалить: rm -rf ~/.local/share/girl-agent ~/.local/bin/girl-agent.
Windows — через npx (рекомендуем)
npx @thesashadev/girl-agent
Хочешь короче — поставь глобально:
npm install -g @thesashadev/girl-agent
girl-agent
Docker (для серверов)
docker run -it --rm -v girl-agent-data:/data ghcr.io/thesashadev/girl-agent:latest
Headless:
docker run -d --name girl-agent --restart=unless-stopped \
-v girl-agent-data:/data \
-v $PWD/bot.json:/config/bot.json:ro \
ghcr.io/thesashadev/girl-agent:latest \
server --config /config/bot.json --headless
Из исходников
git clone https://github.com/TheSashaDev/girl-agent.git
cd girl-agent
npm install
npm run dev
Примечания
- Приведены команды установки и запуска из README; последние версии и детали могут изменяться.
Recent releases
- none
Traction
- 331 stars, 47 forks, 5 open_issues (as of facts)