@thesashadev/girl-agent 0.1.0 → 0.1.1

package/README.md

@@ -1,170 +1,170 @@
-![girl-agent banner](assets/final.png)
-
-[website]: https://girl-agent.dev
-[docs]: docs/index.html
-
-**[website]**  ·  **[docs]**
-
----
-
-## Содержание
-
-- [Быстрый старт](#быстрый-старт)
-- [Что под капотом](#что-под-капотом)
-- [Почему не просто GPTs или промпт](#почему-не-просто-gpts-или-промпт)
-- [Безопасность](#безопасность)
-- [Лицензия](#лицензия)
-
----
-
-## О проекте
-
-Она не отвечает на каждое сообщение. Иногда читает и молчит. Иногда ставит реакцию. Иногда отвечает через час, потому что была занята или просто не хотела.
-
-Это не баг. Так задумано.
-
-`girl-agent` — ИИ-девушка, которая ведёт себя в переписке как человек. Со сном, настроением, расписанием, памятью и характером. Без "конечно, я понимаю" и ChatGPT-повадок.
-
----
-
-## Быстрый старт
-
-```powershell
-git clone https://github.com/TheSashaDev/girl-agent.git
-cd girl-agent
-npm install
-npm run dev
-```
-
-Wizard задаст пару вопросов — имя, возраст, Telegram-подключение, LLM-ключ. Всё.
-
-Если профиль уже есть:
-
-```powershell
-npm run dev -- --profile=arina
-```
-
----
-
-## Что под капотом
-
-Поведение собирается из нескольких слоёв, а не из одного промпта.
-
-- 📱 **Она не всегда онлайн** — паттерн присутствия зависит от персонажа: кто-то в телефоне круглые сутки, кто-то заходит раз в час, кто-то только вечером.
-- 😴 **Ночью спит** — можно разбудить через `:wake`, но без команды шанс ответа низкий.
-- 📅 **Расписание дня** — у каждого дня есть расписание: пары, работа, дорога, свободное время. Если она на занятиях, телефон может быть недоступен.
-- ❤️ **Отношения** — пять счётчиков: интерес, доверие, привлекательность, раздражение, неловкость. Меняются от каждого диалога. Высокое раздражение — чаще игнор и холод.
-- 📈 **Стадии сближения** — отношения проходят стадии: от "дала тг, но холодная" до "давно вместе". Стадия влияет на тепло, флирт, длину ответов.
-- ⚠️ **Конфликты** — если давить, спамить или нарушать границы — включается конфликт. Она может замолчать на часы или дни.
-- 🧠 **Память** — важные события пишутся в `long-term.md` и всплывают в будущих диалогах.
-- 🚫 **Anti-AI** — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды, вопросы в конце сообщений и всё, что палит ChatGPT.
-- 👤 **Userbot mode** — настоящий Telegram-аккаунт через MTProto. Умеет читать сообщения, ставить реакции, печатать, удалять и редактировать. Выглядит как живой человек, а не как бот.
-
----
-
-## Почему не просто GPTs или промпт
-
-Вариантов сделать "девушку в Telegram" несколько — от костыльных до полноценных. Разберём, что есть и где дыры.
-
-### ChatGPT GPTs
-
-**Как это работает:** Кастомный бот внутри ChatGPT с system prompt. Логика поведения = промпт.
-
-**Что упущено:**
-- Нет памяти между сессиями — каждая начинается с нуля
-- Нет Telegram — только веб-интерфейс
-- Нет реакций, печати, редактирования
-- Бот всегда "онлайн" — нет расписания или сна
-- Память ограничена контекстным окном
-
-**Итог:** Чат-бот с кастомным промптом, без состояния и реалистичного поведения.
-
----
-
-### OpenClaw + prompt (markdown-файлы)
-
-**Как это работает:** Фреймворк для AI-ассистентов. Личность через markdown-файлы (SOUL.md, IDENTITY.md, USER.md). Telegram bridge через GramJS (MTProto).
-
-**Что упущено:**
-- Нет реализм-модулей: presence, sleep, conflict, daily-life, relationship stages
-- Нет agenda — бот не планирует действия
-- Память = история сообщений, нет long-term storage
-- Нет relationship score и conflict system
-
-**Итог:** Хороший bridge для Telegram, но не персонаж-движок. Поведение = промпт + история.
-
----
-
-### HeatherBot
-
-**Как это работает:** Локальный Telegram userbot (MTProto via Telethon), persona в YAML, 4-слойная память, 17 kink-specific overlays. ~10K строк Python.
-
-**Что упущено:**
-- Слишком специфично под NSFW — 17 kink overlays
-- Сложно настроить — нужно llama-server, Ollama, ComfyUI
-- Требует мощного GPU — 12B модель локально
-- Нет presence/sleep/conflict как отдельных модулей
-
-**Итог:** Мощное, но узкое решение под NSFW с тяжёлой инфраструктурой.
-
----
-
-### Character.AI
-
-**Как это работает:** Закрытый сервис для AI-переписки. Персоны через UI, поведение = prompt engineering + session-level memory.
-
-**Что упущено:**
-- Нет Telegram — только веб-интерфейс
-- Нет контроля — всё на их серверах
-- Память сбрасывается между сессиями
-- Memory ограничена — persona обрезается при росте истории
-
-**Итог:** Закрытый сервис с ограниченной памятью и без Telegram.
-
----
-
-### girl-agent
-
-**Как это работает:** Движок с несколькими слоями состояния: presence, sleep, daily-life, relationship stages, conflict, memory, anti-AI. Userbot mode через MTProto.
-
-**Технические детали:**
-- Presence — паттерны присутствия (частота, офлайн, вероятность ответа)
-- Sleep — время сна, night wake chance
-- Daily-life — расписание, занятость, приоритеты
-- Relationship stages — stranger → convinced → close → intimate → bonded
-- Relationship score — interest, trust, attraction, annoyance, cringe
-- Conflict — если давить/спамить, включается конфликт, может замолчать
-- Memory — важные события в long-term.md, всплывают в диалогах
-- Anti-AI — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды
-- Userbot mode — умеет читать, реагировать, печатать, удалять, редактировать
-- Agenda — бот планирует действия, живёт своей жизнью
-
-**Итог:** Движок с несколькими слоями решения. Поведение собирается из состояния, а не из текстовых инструкций.
-
----
-
-## Безопасность
-
-⚠️ **Не публикуй:** `data/`, `config.json`, `sessionString` и API-ключи.
-
-🔒 **Для userbot mode** используй отдельный тестовый аккаунт — Telegram может забанить основной аккаунт за подозрительную активность.
-
----
-
-## Лицензия
-
-📄 **Source-available** — исходный код открыт для личного тестирования, оценки и вкладов.
-
-**Разрешено:**
-- Клонировать и запускать локально
-- Создавать issues и отправлять pull requests
-- Изучать код и экспериментировать
-
-**Запрещено без письменного разрешения:**
-- Коммерческое использование
-- Платный хостинг
-- Перепродажа
-- Публичные конкурирующие клоны
-- Использование кода внутри коммерческих продуктов
-
-📜 Полный текст лицензии: [LICENSE](./LICENSE)
+![girl-agent banner](https://girl-agent.com/og-image.png)
+
+[website]: https://girl-agent.com
+[docs]: https://docs.girl-agent.com
+
+**[website]**  ·  **[docs]**
+
+---
+
+## Содержание
+
+- [Быстрый старт](#быстрый-старт)
+- [Что под капотом](#что-под-капотом)
+- [Почему не просто GPTs или промпт](#почему-не-просто-gpts-или-промпт)
+- [Безопасность](#безопасность)
+- [Лицензия](#лицензия)
+
+---
+
+## О проекте
+
+Она не отвечает на каждое сообщение. Иногда читает и молчит. Иногда ставит реакцию. Иногда отвечает через час, потому что была занята или просто не хотела.
+
+Это не баг. Так задумано.
+
+`girl-agent` — ИИ-девушка, которая ведёт себя в переписке как человек. Со сном, настроением, расписанием, памятью и характером. Без "конечно, я понимаю" и ChatGPT-повадок.
+
+---
+
+## Быстрый старт
+
+```powershell
+git clone https://github.com/TheSashaDev/girl-agent.git
+cd girl-agent
+npm install
+npm run dev
+```
+
+Wizard задаст пару вопросов — имя, возраст, Telegram-подключение, LLM-ключ. Всё.
+
+Если профиль уже есть:
+
+```powershell
+npm run dev -- --profile=arina
+```
+
+---
+
+## Что под капотом
+
+Поведение собирается из нескольких слоёв, а не из одного промпта.
+
+- 📱 **Она не всегда онлайн** — паттерн присутствия зависит от персонажа: кто-то в телефоне круглые сутки, кто-то заходит раз в час, кто-то только вечером.
+- 😴 **Ночью спит** — можно разбудить через `:wake`, но без команды шанс ответа низкий.
+- 📅 **Расписание дня** — у каждого дня есть расписание: пары, работа, дорога, свободное время. Если она на занятиях, телефон может быть недоступен.
+- ❤️ **Отношения** — пять счётчиков: интерес, доверие, привлекательность, раздражение, неловкость. Меняются от каждого диалога. Высокое раздражение — чаще игнор и холод.
+- 📈 **Стадии сближения** — отношения проходят стадии: от "дала тг, но холодная" до "давно вместе". Стадия влияет на тепло, флирт, длину ответов.
+- ⚠️ **Конфликты** — если давить, спамить или нарушать границы — включается конфликт. Она может замолчать на часы или дни.
+- 🧠 **Память** — важные события пишутся в `long-term.md` и всплывают в будущих диалогах.
+- 🚫 **Anti-AI** — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды, вопросы в конце сообщений и всё, что палит ChatGPT.
+- 👤 **Userbot mode** — настоящий Telegram-аккаунт через MTProto. Умеет читать сообщения, ставить реакции, печатать, удалять и редактировать. Выглядит как живой человек, а не как бот.
+
+---
+
+## Почему не просто GPTs или промпт
+
+Вариантов сделать "девушку в Telegram" несколько — от костыльных до полноценных. Разберём, что есть и где дыры.
+
+### ChatGPT GPTs
+
+**Как это работает:** Кастомный бот внутри ChatGPT с system prompt. Логика поведения = промпт.
+
+**Что упущено:**
+- Нет памяти между сессиями — каждая начинается с нуля
+- Нет Telegram — только веб-интерфейс
+- Нет реакций, печати, редактирования
+- Бот всегда "онлайн" — нет расписания или сна
+- Память ограничена контекстным окном
+
+**Итог:** Чат-бот с кастомным промптом, без состояния и реалистичного поведения.
+
+---
+
+### OpenClaw + prompt (markdown-файлы)
+
+**Как это работает:** Фреймворк для AI-ассистентов. Личность через markdown-файлы (SOUL.md, IDENTITY.md, USER.md). Telegram bridge через GramJS (MTProto).
+
+**Что упущено:**
+- Нет реализм-модулей: presence, sleep, conflict, daily-life, relationship stages
+- Нет agenda — бот не планирует действия
+- Память = история сообщений, нет long-term storage
+- Нет relationship score и conflict system
+
+**Итог:** Хороший bridge для Telegram, но не персонаж-движок. Поведение = промпт + история.
+
+---
+
+### HeatherBot
+
+**Как это работает:** Локальный Telegram userbot (MTProto via Telethon), persona в YAML, 4-слойная память, 17 kink-specific overlays. ~10K строк Python.
+
+**Что упущено:**
+- Слишком специфично под NSFW — 17 kink overlays
+- Сложно настроить — нужно llama-server, Ollama, ComfyUI
+- Требует мощного GPU — 12B модель локально
+- Нет presence/sleep/conflict как отдельных модулей
+
+**Итог:** Мощное, но узкое решение под NSFW с тяжёлой инфраструктурой.
+
+---
+
+### Character.AI
+
+**Как это работает:** Закрытый сервис для AI-переписки. Персоны через UI, поведение = prompt engineering + session-level memory.
+
+**Что упущено:**
+- Нет Telegram — только веб-интерфейс
+- Нет контроля — всё на их серверах
+- Память сбрасывается между сессиями
+- Memory ограничена — persona обрезается при росте истории
+
+**Итог:** Закрытый сервис с ограниченной памятью и без Telegram.
+
+---
+
+### girl-agent
+
+**Как это работает:** Движок с несколькими слоями состояния: presence, sleep, daily-life, relationship stages, conflict, memory, anti-AI. Userbot mode через MTProto.
+
+**Технические детали:**
+- Presence — паттерны присутствия (частота, офлайн, вероятность ответа)
+- Sleep — время сна, night wake chance
+- Daily-life — расписание, занятость, приоритеты
+- Relationship stages — stranger → convinced → close → intimate → bonded
+- Relationship score — interest, trust, attraction, annoyance, cringe
+- Conflict — если давить/спамить, включается конфликт, может замолчать
+- Memory — важные события в long-term.md, всплывают в диалогах
+- Anti-AI — промпт запрещает markdown, "конечно", "я понимаю", эмодзи-ряды
+- Userbot mode — умеет читать, реагировать, печатать, удалять, редактировать
+- Agenda — бот планирует действия, живёт своей жизнью
+
+**Итог:** Движок с несколькими слоями решения. Поведение собирается из состояния, а не из текстовых инструкций.
+
+---
+
+## Безопасность
+
+⚠️ **Не публикуй:** `data/`, `config.json`, `sessionString` и API-ключи.
+
+🔒 **Для userbot mode** используй отдельный тестовый аккаунт — Telegram может забанить основной аккаунт за подозрительную активность.
+
+---
+
+## Лицензия
+
+📄 **Source-available** — исходный код открыт для личного тестирования, оценки и вкладов.
+
+**Разрешено:**
+- Клонировать и запускать локально
+- Создавать issues и отправлять pull requests
+- Изучать код и экспериментировать
+
+**Запрещено без письменного разрешения:**
+- Коммерческое использование
+- Платный хостинг
+- Перепродажа
+- Публичные конкурирующие клоны
+- Использование кода внутри коммерческих продуктов
+
+📜 Полный текст лицензии: [LICENSE](./LICENSE)

package/package.json

@@ -1,64 +1,64 @@
-{
-  "name": "@thesashadev/girl-agent",
-  "version": "0.1.0",
-  "description": "Telegram AI persona engine with memory, schedule, relationship state and MTProto userbot mode.",
-  "type": "module",
-  "bin": {
-    "girl-agent": "dist/cli.js"
-  },
-  "main": "dist/cli.js",
-  "files": [
-    "dist",
-    "templates",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/cli.tsx",
-    "start": "node dist/cli.js",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run typecheck && npm run build"
-  },
-  "author": "TheSashaDev (void)",
-  "license": "SEE LICENSE IN LICENSE",
-  "keywords": [
-    "telegram",
-    "ai",
-    "agent",
-    "tui",
-    "ink",
-    "mcp",
-    "userbot",
-    "llm",
-    "persona",
-    "anthropic",
-    "openai"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.32.1",
-    "@modelcontextprotocol/sdk": "^1.0.4",
-    "grammy": "^1.30.0",
-    "ink": "^5.0.1",
-    "ink-big-text": "^2.0.0",
-    "ink-gradient": "^3.0.0",
-    "ink-select-input": "^6.0.0",
-    "ink-spinner": "^5.0.0",
-    "ink-text-input": "^6.0.0",
-    "input": "^1.0.1",
-    "mri": "^1.2.0",
-    "openai": "^4.77.0",
-    "react": "^18.3.1",
-    "telegram": "^2.26.16"
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.2",
-    "@types/react": "^18.3.18",
-    "tsup": "^8.3.5",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.2"
-  }
-}
+{
+  "name": "@thesashadev/girl-agent",
+  "version": "0.1.1",
+  "description": "Telegram AI persona engine with memory, schedule, relationship state and MTProto userbot mode.",
+  "type": "module",
+  "bin": {
+    "girl-agent": "dist/cli.js"
+  },
+  "main": "dist/cli.js",
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/cli.tsx",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "author": "TheSashaDev (void)",
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "telegram",
+    "ai",
+    "agent",
+    "tui",
+    "ink",
+    "mcp",
+    "userbot",
+    "llm",
+    "persona",
+    "anthropic",
+    "openai"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.32.1",
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "grammy": "^1.30.0",
+    "ink": "^5.0.1",
+    "ink-big-text": "^2.0.0",
+    "ink-gradient": "^3.0.0",
+    "ink-select-input": "^6.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "input": "^1.0.1",
+    "mri": "^1.2.0",
+    "openai": "^4.77.0",
+    "react": "^18.3.1",
+    "telegram": "^2.26.16"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/react": "^18.3.18",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}