@thesashadev/girl-agent 0.1.0

package/LICENSE

@@ -0,0 +1,31 @@
+girl-agent Source-Available Non-Commercial License
+
+Copyright (c) 2026 girl-agent contributors.
+All rights reserved except as expressly stated below.
+
+Permission is granted to view, download, clone, and run this software
+for personal, educational, evaluation, and non-commercial testing purposes.
+
+Permission is also granted to create forks and submit issues, pull requests,
+bug reports, patches, and improvement suggestions to the original repository.
+
+You may modify the software only for the purpose of personal testing,
+evaluation, or contributing improvements back to the original project.
+
+You may not, without prior written permission from the copyright holder:
+
+1. use this software or substantial portions of it for commercial purposes;
+2. sell, rent, sublicense, host, or provide this software as a paid service;
+3. publish or distribute a competing product or public clone based on this software;
+4. use this software in a commercial product, service, or company project;
+5. remove or alter copyright notices, attribution, or license terms;
+6. relicense this software under another license;
+7. use the project name, branding, logo, documentation, or assets in a way that suggests endorsement or ownership.
+
+Any contribution submitted to the original repository, including pull requests,
+patches, issues, ideas, documentation changes, or code suggestions, may be used,
+modified, and distributed by the project maintainers as part of this project.
+
+This license does not grant any trademark rights.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -0,0 +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)