Skip to content

About

Персональный AI-психолог: переиспользуемый privacy-first шаблон для сборки своего AI-со-терапевта. Отношения — как пример-вертикаль.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

hermes-psycho

Движок персонального AI-психолога. Форкаешь репозиторий — и собираешь своего со-мыслителя под любой домен: тревога, самооценка, карьера, привычки, отношения. В комплекте идёт готовая вертикаль «отношения» как рабочий пример: на ней видно, как связаны все три слоя и как из одного манифеста разворачивается персона агента.

Это не чат-бот с промптом. Это база методологии + операционные плейбуки + персона, которые собираются в одного агента, живущего в Telegram и работающего только на своего владельца.


Как этим пользоваться (в двух словах)

Ты не учишь команды — пишешь боту своими словами, агент сам выбирает нужный протокол. Первые шаги, когда бот запущен:

  1. «хочу рассказать о себе» → онбординг-интервью наполняет твою карту (self/) и карточки людей. Без этого разборы будут общими.
  2. «разбери разговор с X» + текст переписки (или голосовое, если настроен STT) → бот сохранит и разберёт, обновит обещания и «что дальше».
  3. «прогони через оптики» / «покажи паттерны» / «памятка перед разговором с X» / «обзор недели» — по мере надобности.

💡 Паттерны запускаются и фразой «покажи паттерны», и командой /patterns — профиль регистрирует свой скил, оба ведут в один протокол pattern-review. Пока база пуста, он честно скажет «данных нет, давай онбординг», а не выдаст выдуманную простыню.

Полная шпаргалка фраз — docs/COMMANDS.md; сквозные примеры «что пишешь → что получаешь» — docs/SCENARIOS.md. Как поставить и запустить — docs/INSTALL.md.


Что это

Три слоя, у каждого своя ответственность:

  • knowledge/ — методология. Общие психологические фреймворки без личных историй: attachment (стили привязанности), ifs (Internal Family Systems), schema-therapy, communication (Gottman / NVC), systemic (роли, петли, границы), family, self-regulation. Плюс RESOLVER.md — маршрутизатор «ситуация → слой → протокол», schema.md — формат страницы, 00-index.md — карта базы.
  • protocols/ — операционные «шляпы» агента. Как обработать разговор, прогнать ситуацию через несколько оптик (multi-lens-read), отследить обещания, собрать weekly-review, среагировать на red-flags, провести life-interview. Реестр — protocols/00-index.md.
  • hermes/SOUL.md — персона агента: роль, тон, язык, обращение. Не пишется руками — генерируется из hermes-profile.yaml.

Публичное отделено от приватного. В семантический индекс (gbrain) идёт только теория из knowledge/ — без единого личного факта. Личные записи (people/, self/, contexts/) агент читает напрямую через grep/файлы; они в .gitignore и никогда не покидают локальную машину.


Структура репозитория

hermes-psycho/
├── hermes-profile.yaml     # единый манифест профиля: owner, домен, персона, деплой
├── hermes/
│   └── SOUL.md             # персона агента (генерируется из манифеста)
├── knowledge/              # методология → семантический индекс (без PII)
│   ├── RESOLVER.md         # маршрутизатор: ситуация → оптика → протокол
│   ├── schema.md           # формат страницы, дедуп, эпистемические правила
│   ├── 00-index.md         # карта базы методологии
│   ├── attachment/         # стили привязанности, триггеры, репэйр
│   ├── ifs/                # части в близости и конфликте, протокол 6F
│   ├── schema-therapy/     # схемы, режимы, копинг-стили
│   ├── communication/      # Gottman, NVC, repair attempts
│   ├── systemic/           # роли, петли, границы, власть/agency
│   ├── family/             # семья происхождения, дифференциация, границы
│   ├── self-regulation/    # самосаботаж, прокрастинация, страх отказа
│   ├── templates/          # шаблоны новых страниц
│   └── _meta/              # журнал правок владельца (без PII)
├── protocols/              # плейбуки агента + реестр 00-index.md
├── scripts/                # рендер профиля, гейты приватности, gbrain, обслуживание
│   ├── render-hermes-profile.py
│   ├── check-hermes-profile.sh
│   ├── check-privacy.sh
│   └── check-structure.sh
├── deploy/
│   └── relationship/       # ранбук деплоя вертикали: Telegram-бот, gbrain, allowlist
├── docs/
│   └── CUSTOMIZATION.md     # гайд «собери своего AI-психолога за 5 шагов»
├── tests/                  # тесты рендера профиля
├── people/                 # ← GITIGNORED: страницы людей (в репо только _TEMPLATE)
├── self/                   # ← GITIGNORED: карта владельца (в репо только _TEMPLATE)
└── contexts/               # ← GITIGNORED: контексты разговоров (создаётся локально)

Быстрый старт

  1. Форкни репозиторий.
  2. Отредактируй hermes-profile.yaml — единственный источник правды о профиле: владелец, домен, имя ассистента, роль и тон персоны, таймзона.
  3. Сгенерируй персону и конфиги:
    python3 scripts/render-hermes-profile.py --write
    Это перепишет hermes/SOUL.md, config.yaml.example и bash-скрипты из манифеста.
  4. Проверь сборку — один smoke-прогон без сети и контейнера:
    bash scripts/verify.sh
    Он гоняет render --check, тесты, гейт приватности и гейт структуры и печатает компактный OK/FAIL по шагам. Тесты отдельно — bash scripts/test.sh (НЕ голый python3 -m unittest discover из корня — он находит 0 тестов и «зеленеет» вхолостую).
  5. Посмотри _TEMPLATE-шаблоны в people/ и self/ и выдуманный пример в examples/ — чтобы понять, как агент хранит и читает личный контекст.
  6. Разверни по ранбуку deploy/relationship/README.md (Telegram-бот, gbrain-индекс, single-user allowlist).

Пошаговый разбор кастомизации под свой домен — в docs/CUSTOMIZATION.md. Сквозные сценарии — docs/SCENARIOS.md; шпаргалка команд — docs/COMMANDS.md; устройство движка — docs/ARCHITECTURE.md.

Установка — два тира

  • Тир 1 — быстрый локальный. Claude Code + форк hermes-psycho: правишь манифест и базу, общаешься с агентом прямо в Claude Code по файлам репозитория. Семантический индекс gbrain — опционально (без него агент читает knowledge/ через grep). Ни сервера, ни Telegram.
  • Тир 2 — полный self-host. Тот же пак разворачивается в контейнер Hermes и живёт в Telegram: голосовые (STT), крон-ритуалы, single-user allowlist. Это путь из deploy/relationship/README.md.

Что ставить, в каком порядке и с какими ключами — подробно в docs/INSTALL.md.

Локально vs на сервере

Частый вопрос: «а где веб-приложение / какой порт открыть?». Локально запускать нечего — это контент/конфиг-пак, а не сервер. Локально ты только авторишь (правишь манифест и knowledge//protocols/) и валидируешь (render → scripts/verify.sh). Ни порта, ни UI, ни dev server. Запуск = деплой: по ранбуку deploy/relationship/README.md пак разворачивается в контейнер внешнего фреймворка Hermes, и ты общаешься с ним через своего Telegram-бота. Подробнее — docs/ARCHITECTURE.md.

Онбординг / первый запуск

После деплоя система пустая: self/ и people/ — только шаблоны, агенту не с чем сверяться, и разборы будут generic. Наполнить её можно четырьмя путями (комбинируются в любом порядке):

  1. Интервью — первое сообщение боту «хочу рассказать о себе» (или /onboarding). Запускает протокол life-interview: агент по блокам (происхождение, семья, романтика, бизнес, друзья) задаёт по 2–3 вопроса за раз, пишет выжимку в self/map.md и self/spheres/, заводит карточки людей в people/<slug>/. Прервать можно в любой момент — прогресс в self/interview-progress.md.
  2. Транскрипты психотерапии — в data/raw/therapy/.
  3. Дневники — в data/raw/journals/.
  4. Переписки с важными людьми — в data/raw/chats/.

Для путей 2–4: положил сырьё в data/raw/… → сказал «переработай инбокс» (или /ingest) → агент дистиллирует его в self/ и people/ по протоколу ingest. Сырьё остаётся локально, в индекс не идёт. Пока карта не собрана, разборы (multi-lens-read, pattern-review) честно скажут, что данных ещё нет.

Канонический гайд онбординга (4 пути в таблице, рекомендованный порядок, приватность) — docs/ONBOARDING.md.

Ритм использования. Первую неделю — в основном онбординг: пройти life-interview и бэкфилл текущих связей (пара разговоров по каждому значимому человеку, чтобы карты перестали быть пустыми). Дальше — корми систему после каждого значимого разговора, а раз в неделю запускай обзор (Сценарий D). База пуста и разборы generic, пока ты её не наполнил — именно эта привычка кормить и делает систему ценной. Разбор без данных честно скажет «данных нет», а не выдумает паттерн.


Как кормить систему

Разборы хороши ровно настолько, насколько наполнена база. «Кормить» = слать агенту материал разговоров и наблюдения о людях.

📥 Первичное наполнение — это онбординг. Кроме интервью, базу можно быстро наполнить из насыщенных источников: транскрипты терапии, дневники, переписки. Кладёшь их в data/raw/{therapy,journals,chats}/, говоришь «переработай инбокс» (/ingest) — агент дистиллирует. Все четыре пути и порядок — в docs/ONBOARDING.md. Ниже — про ежедневный режим: как докидывать отдельные разговоры.

Два канала для разговоров:

  • Текст — работает всегда. Кидаешь диалог дословно ИЛИ пересказ своими словами и называешь человека: «разбери разговор с Кимом про переезд». Slug агент подберёт сам по people/_index.md; нового человека заведёт, спросив имя. Дословность полезна (меньше твоей интерпретации), но пересказ тоже годится.
  • Голос — только если настроен STT. Голосовое расшифровывается автоматически, но лишь когда в деплое включён STT: stt.enabled: true + provider: xai в конфиге и XAI_API_KEY в окружении (Тир 2). Без STT голос слать бесполезно — шли текст. Голосовые в Telegram ≤20 МБ проходят как есть; большая запись разговора (>20 МБ) требует локального Bot API overlay (compose.tg-bot-api.yaml, см. deploy/relationship/README.md).

Что происходит дальше. Материал уходит в process-conversation: агент сначала сохраняет транскрипт/пересказ в people/<slug>/conversations/YYYY-MM-DD-тема.md, затем читает базу (brain-first) и обновляет people/<slug>/map.md (динамика связи), commitments.md (кто/что/срок из разговора) и next.md (что сделать до следующего контакта). В чат приходит выжимка ≤10 строк, полный разбор — в файле. Мелкий факт «не разговор, а деталь» («кстати, Ким сменил работу») уходит в add-context → notes.md.


Не только про отношения

Вертикаль «отношения» — это пример, а не потолок. Ядро переиспользуется под другие домены почти без изменений, потому что базовые слои — общие психологические фреймворки, не привязанные к теме близости:

  • Тревога / самооценка — attachment, ifs и schema-therapy напрямую описывают триггеры, внутренние части и глубинные схемы, которые крутятся вокруг любого стрессора, а не только отношений.
  • Карьера / прокрастинация — self-regulation (Upper Limit, страх отказа, прокрастинация как регуляция эмоций) и systemic (роли, границы, баланс agency) работают на рабочем контексте так же, как на личном.
  • Привычки — self-regulation + communication (как договариваться с собой и близкими) дают каркас без единой строки про «пару».

Меняешь домен в манифесте, оставляешь универсальные слои, добавляешь один-два своих по формату knowledge/schema.md, обновляешь knowledge/RESOLVER.md — и тот же движок работает на новую тему.


Приватность

Приватность заложена в архитектуру, а не прикручена сбоку:

  • people/, self/, contexts/, data/, аудио и транскрипты — в .gitignore. В публичном репозитории лежат только _TEMPLATE-шаблоны и выдуманный examples/. Реальные данные не коммитятся никогда.
  • В семантический индекс (gbrain) идёт только knowledge/ — общая теория без PII. Личные записи агент читает через grep/файлы, они не эмбедятся.
  • scripts/check-privacy.sh — гейт: сверяется с денилистом (.privacy-denylist) и проверяет, что личные каталоги и секреты не попали под git. Прогоняй перед каждым коммитом.
  • scripts/check-structure.sh — проверяет, что дерево репозитория соответствует ожидаемой раскладке.

Происхождение

Построено на фреймворке Hermes — персональном агент-движке (профиль, SOUL, gbrain-индекс, Telegram-деплой, крон-ритуалы). hermes-psycho — это специализация Hermes под задачу персонального AI-психолога: методология в knowledge/, плейбуки в protocols/, single-user изоляция.


Дисклеймер

Это инструмент со-мышления, а не медицинская помощь. Он не ставит диагнозов, не назначает лечение и не заменяет живого психотерапевта или психиатра. При остром кризисе, риске для жизни или насилии — обращайся к специалистам и экстренным службам, а не к боту. Красные флаги (абьюз, токсичность, суицидальные мысли) вынесены в protocols/red-flags.md и protocols/crisis-support.md именно для того, чтобы агент их не «прорабатывал», а разворачивал к реальной помощи.

About

Персональный AI-психолог: переиспользуемый privacy-first шаблон для сборки своего AI-со-терапевта. Отношения — как пример-вертикаль.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages