Движок персонального AI-психолога. Форкаешь репозиторий — и собираешь своего со-мыслителя под любой домен: тревога, самооценка, карьера, привычки, отношения. В комплекте идёт готовая вертикаль «отношения» как рабочий пример: на ней видно, как связаны все три слоя и как из одного манифеста разворачивается персона агента.
Это не чат-бот с промптом. Это база методологии + операционные плейбуки + персона, которые собираются в одного агента, живущего в Telegram и работающего только на своего владельца.
Ты не учишь команды — пишешь боту своими словами, агент сам выбирает нужный протокол. Первые шаги, когда бот запущен:
- «хочу рассказать о себе» → онбординг-интервью наполняет твою карту (
self/) и карточки людей. Без этого разборы будут общими. - «разбери разговор с X» + текст переписки (или голосовое, если настроен STT) → бот сохранит и разберёт, обновит обещания и «что дальше».
- «прогони через оптики» / «покажи паттерны» / «памятка перед разговором с 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: контексты разговоров (создаётся локально)
- Форкни репозиторий.
- Отредактируй
hermes-profile.yaml— единственный источник правды о профиле: владелец, домен, имя ассистента, роль и тон персоны, таймзона. - Сгенерируй персону и конфиги:
Это перепишет
python3 scripts/render-hermes-profile.py --write
hermes/SOUL.md,config.yaml.exampleи bash-скрипты из манифеста. - Проверь сборку — один smoke-прогон без сети и контейнера:
Он гоняет render
bash scripts/verify.sh
--check, тесты, гейт приватности и гейт структуры и печатает компактный OK/FAIL по шагам. Тесты отдельно —bash scripts/test.sh(НЕ голыйpython3 -m unittest discoverиз корня — он находит 0 тестов и «зеленеет» вхолостую). - Посмотри
_TEMPLATE-шаблоны вpeople/иself/и выдуманный пример вexamples/— чтобы понять, как агент хранит и читает личный контекст. - Разверни по ранбуку
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.
Частый вопрос: «а где веб-приложение / какой порт открыть?». Локально запускать нечего —
это контент/конфиг-пак, а не сервер. Локально ты только авторишь (правишь манифест и
knowledge//protocols/) и валидируешь (render → scripts/verify.sh). Ни порта, ни UI,
ни dev server. Запуск = деплой: по ранбуку deploy/relationship/README.md пак разворачивается
в контейнер внешнего фреймворка Hermes, и ты общаешься с ним через своего Telegram-бота.
Подробнее — docs/ARCHITECTURE.md.
После деплоя система пустая: self/ и people/ — только шаблоны, агенту не с чем сверяться,
и разборы будут generic. Наполнить её можно четырьмя путями (комбинируются в любом порядке):
- Интервью — первое сообщение боту «хочу рассказать о себе» (или
/onboarding). Запускает протокол life-interview: агент по блокам (происхождение, семья, романтика, бизнес, друзья) задаёт по 2–3 вопроса за раз, пишет выжимку вself/map.mdиself/spheres/, заводит карточки людей вpeople/<slug>/. Прервать можно в любой момент — прогресс вself/interview-progress.md. - Транскрипты психотерапии — в
data/raw/therapy/. - Дневники — в
data/raw/journals/. - Переписки с важными людьми — в
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
именно для того, чтобы агент их не «прорабатывал», а разворачивал к реальной помощи.