Это бета. Со всеми проблемами и багами — в Issues или @voided_net.

Она не отвечает на каждое сообщение. Иногда читает и молчит. Иногда ставит реакцию. Иногда отвечает через час, потому что была занята или просто не хотела.

Это не баг. Так задумано.

girl-agent — движок ИИ-персоны для Telegram. Не промпт. Не GPTs. Не плагин. Это полноценный агент со своим состоянием: расписание дня, паттерн присутствия, сон, память на месяцы вперёд, конфликт-система, пять счётчиков отношений, девять стадий сближения. Поведение собирается из этих слоёв, а не из одного system_prompt.

• Быстрый старт
  • Linux / macOS / WSL — одной командой
  • Windows — через npx
  • Если уже есть Node ≥ 22
  • Docker (для серверов)
• Что под капотом
• Почему не просто GPTs или промпт
• Документация
• Безопасность
• Лицензия
• Changelog

Без Node на машине, без sudo:

curl -fsSL https://raw.githubusercontent.com/TheSashaDev/girl-agent/master/scripts/install.sh | sh

Что произойдёт:

• определит OS + arch (linux x64/arm64, macos x64/arm64, wsl);
• если есть Docker → поставит Docker-обёртку (полная изоляция от системы);
• иначе → скачает официальный Node.js 22 LTS в ~/.local/share/girl-agent/runtime/ и поставит туда же @thesashadev/girl-agent (системный Node не трогается);
• положит shim girl-agent в ~/.local/bin/girl-agent;
• ничего не пишется в /usr/local/, sudo не нужен.

Дальше:

girl-agent                  # интерактивный визард первичной настройки
girl-agent --profile=arina  # запустить готовый профиль
girl-agent server --help    # серверный режим (без TTY, для systemd / cron / CI)

Опции установщика:

curl -fsSL .../install.sh | sh -s -- --docker        # форсировать Docker
curl -fsSL .../install.sh | sh -s -- --local         # форсировать локальную Node
curl -fsSL .../install.sh | sh -s -- --version=0.4.1 # конкретную версию пакета

Удалить: rm -rf ~/.local/share/girl-agent ~/.local/bin/girl-agent.

Самый быстрый способ. Без установщика, без WSL, без Docker.

1. Скачай и поставь Node.js 22 LTS (.msi-инсталлер, галочка Add to PATH).

2. В PowerShell:

   npx @thesashadev/girl-agent

   Первый запуск скачает пакет (~30 МБ) и откроет визард прямо в PowerShell. WebUI поднимется на http://localhost:3000.

Хочешь короче — поставь глобально:

npm install -g @thesashadev/girl-agent
girl-agent

Нужен системный лоток и автозапуск? Есть нативный десктоп-клиент на Rust — готовые бинари в Releases.

npx @thesashadev/girl-agent
npx @thesashadev/girl-agent --profile=arina

Или глобально:

npm install -g @thesashadev/girl-agent
girl-agent

Интерактивная первичная настройка (визард внутри контейнера):

docker run -it --rm -v girl-agent-data:/data ghcr.io/thesashadev/girl-agent:latest

Headless (для systemd / docker-compose / k8s) — сначала готовим конфиг, потом запускаем без TTY:

# 1) шаблон конфига
docker run --rm ghcr.io/thesashadev/girl-agent:latest server --print-config > bot.json

# 2) отредактировать bot.json (token, api-key)

# 3) поднять в фоне
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

Или совсем без файла, через env-vars:

docker run -d --name girl-agent --restart=unless-stopped \
  -v girl-agent-data:/data \
  -e GIRL_AGENT_MODE=bot \
  -e GIRL_AGENT_TOKEN=... \
  -e GIRL_AGENT_API_PRESET=claudehub \
  -e GIRL_AGENT_API_KEY=... \
  -e GIRL_AGENT_NAME='Аня' -e GIRL_AGENT_AGE=22 \
  ghcr.io/thesashadev/girl-agent:latest \
  server --headless

Готовые шаблоны (можно скопировать прямо из бинаря):

girl-agent server --print-config    # bot.json
girl-agent server --print-systemd   # /etc/systemd/system/girl-agent.service
girl-agent server --print-docker    # Dockerfile / compose / k8s snippets

И в корне: docker-compose.example.yml.

Из исходников:

git clone https://github.com/TheSashaDev/girl-agent.git
cd girl-agent
npm install
npm run dev

Поведение собирается из нескольких слоёв, а не из одного промпта.

Подробный разбор каждого слоя →

Вариантов сделать «девушку в Telegram» несколько — от костыльных до полноценных. Разберём что есть и где дыры.

⚠️ Не публикуй: data/, config.json, sessionString, API-ключи.

🔒 Для userbot-режима используй отдельный тестовый аккаунт — Telegram может забанить основной за подозрительную активность.

Подробнее: Security & Privacy →

📄 Source-available — исходный код открыт для личного тестирования, оценки и вкладов.

📜 Полный текст: LICENSE.