Пошаговая инструкция: одно хранилище на компьютере и сервере, база знаний по методу Карпати и память между Telegram, терминалом и другими интерфейсами.
Сначала выясним, есть ли у вас GitHub, затем соберём три значения. После этого все команды ниже станут готовыми — ничего исправлять вручную не придётся.
Что мы сейчас делаем: определяем, нужна ли регистрация. GitHub будет закрытым «мостом», через который память Hermes перейдёт с компьютера на сервер и обратно.
Что мы сейчас делаем: создаём личный аккаунт. Зачем: в нём будет закрытая папка с файлами памяти. Посторонние её не увидят.
Нажмите кнопку «Открыть регистрацию GitHub» — сайт откроется в новой вкладке.
Введите свою электронную почту и придумайте пароль. Пароль сохраните в своём менеджере паролей, а не в этой инструкции.
В поле Username придумайте логин латинскими буквами. Например: anna-petrova. Запомните его — он понадобится на следующем шаге.
Завершите регистрацию и подтвердите электронную почту в письме от GitHub.
Вернитесь на эту страницу и нажмите «Аккаунт создан».
Что мы сейчас делаем: собираем адреса, из которых страница составит персональные команды. Никакие пароли здесь не нужны.
Откройте GitHub и нажмите на аватар справа вверху. Логин написан под именем. Если адрес страницы выглядит как github.com/anna-petrova, ваш логин — anna-petrova.
Откройте личный кабинет хостинга → раздел VPS → выберите сервер. Скопируйте значение из строки «IP-адрес». Это не адрес сайта и не пароль.
Посмотрите на начало строки терминала сервера. В root@server пользователь — root. В anna@server пользователь — anna. Нужно слово слева от @.
Репозиторий и папка памяти будут называться hermes-memory-vault. Менять их не нужно.
Что мы сейчас делаем: проверяем адреса до начала установки. Зачем: одна ошибка в логине или IP испортит все последующие команды.
Obsidian устанавливается только на компьютер. На сервере находится обычная папка с Markdown-файлами. Hermes читает и изменяет её без графического приложения Obsidian.
Создаём одно хранилище, отправляем его в приватный репозиторий и подключаем к серверу.
Установите Obsidian и GitHub Desktop. В GitHub Desktop создайте новый локальный репозиторий с тем же названием, которое указали выше. Затем откройте эту папку в Obsidian как хранилище.
File → New repository → Name → Create repository.
«Открыть папку как хранилище» → выбрать папку репозитория.
На GitHub репозиторий обязательно делаем Private. Пароли, токены, API-ключи и файл .env в него не добавляем.
В корне хранилища создайте файл .gitignore и вставьте в него содержимое ниже. Оно исключит временное состояние интерфейса Obsidian.
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/cache/
.trash/
.DS_Store
Thumbs.db
.envВ GitHub Desktop нажмите Commit to main, затем Publish repository и проверьте, что галочка приватности включена.
Откройте PowerShell на компьютере и выполните готовую команду:
После входа слева должно быть имя пользователя, указанное в настройках страницы. Если вы вошли как root, а Hermes работает как другой пользователь, сначала переключитесь на него.
Этот ключ нужен серверу, чтобы забирать и отправлять изменения в приватный репозиторий. Он не является паролем от аккаунта GitHub.
Скопируйте строку, начинающуюся с ssh-ed25519. На странице репозитория GitHub откройте Settings → Deploy keys → Add deploy key. Включите Allow write access.
Сначала указываем Git, какой ключ использовать для GitHub:
При первом подключении сервер спросит, доверяете ли вы адресу GitHub. Введите yes. После успешной проверки клонируйте репозиторий:
На компьютере создайте в Obsidian файл test-from-computer.md, затем выполните Commit и Push в GitHub Desktop. На сервере запустите:
В списке должен появиться файл test-from-computer.md.
Создадим тестовую заметку на сервере и отправим её обратно:
В GitHub Desktop нажмите Fetch origin, затем Pull origin. Файл появится в Obsidian.
Hermes уже содержит навык LLM Wiki. Он превращает папку Markdown в связанную, растущую базу знаний.
Команда добавит переменную WIKI_PATH в настройки того пользователя, под которым запущен Hermes:
Запустите Hermes командой hermes, затем отправьте ему этот запрос:
Три главных файла: SCHEMA.md объясняет правила, index.md показывает, что уже известно, log.md хранит последние изменения.
Создаём проектную инструкцию, которую Hermes будет видеть при работе из этой папки:
После того как Hermes создаст файлы, фиксируем изменения:
На компьютере нажмите Fetch/Pull в GitHub Desktop. В Obsidian появятся папки базы, индекс и журнал.
Telegram, терминал и Dashboard должны использовать один профиль Hermes и один файл истории state.db.
Команда покажет, от какого пользователя работает gateway:
Если сервис работает от одного пользователя, а Hermes в терминале запускается от другого, у них разные память и история. Команды CLI нужно запускать после sudo -iu .
Эта диагностическая команда ничего не изменяет. Она только показывает, сколько файлов state.db существует:
В списке сессий должны встречаться источники telegram, cli и другие используемые интерфейсы.
Выполните команды от того же пользователя и в том же профиле, что использует gateway:
Короткие ключевые факты, загружаемые в новую сессию.
Полные разговоры из Telegram, CLI и других источников.
Память и проектные инструкции загружаются при создании сессии. После настройки перезапустите сервис:
В Telegram создайте новую сессию командой /new.
Сначала обязательно проверьте ручной обмен в обе стороны. Затем можно включить безопасный сценарий.
Если один и тот же файл одновременно изменить на компьютере и сервере, Git может остановиться из-за конфликта. В начале работы придерживайтесь правила: один файл в один момент редактирует либо человек, либо Hermes.
Команда удалит старую строку этого же задания, если она существует, и добавит запуск раз в 10 минут:
| Что проверяем | Правильный результат |
|---|---|
| Файл с компьютера | Появляется на сервере после Pull |
| Файл с сервера | Появляется в Obsidian после Fetch/Pull |
| База Карпати | Есть SCHEMA.md, index.md, log.md и связанные страницы |
| Пользователь Hermes | Gateway и CLI работают от одного пользователя |
| Прошлые разговоры | Telegram и CLI видны в hermes sessions list |
| Новая сессия | Hermes ищет прошлое через session_search, затем читает wiki |
Obsidian хранит понятную человеку базу, GitHub передаёт её между компьютером и сервером, а единый профиль Hermes связывает разговоры из разных интерфейсов.
Основано на актуальной документации памяти Hermes, сессий и навыка LLM Wiki.
