Newer
Older
AI_Lab_SCRUME_Co / INSTALL.md

Инструкция по установке

Агент Dionis — профиль Hermes Agent: личный помощник. Ставится одной командой, ключ API у каждого свой.


0. Что нужно заранее

Что Проверка Если нет
Windows 10/11 — —
Git git --version winget install Git.Git
Hermes Agent hermes --version см. шаг 1
Свой ключ Polza.ai — см. шаг 4

Данные Hermes лежат в %LOCALAPPDATA%\hermes. Агент встанет в %LOCALAPPDATA%\hermes\profiles\vasily.


1. Поставить Hermes Agent (если ещё нет)

PowerShell (обычный, без администратора):

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

После установки закрыть и открыть терминал заново — установщик добавляет hermes в PATH. Проверка:

hermes --version

2. Получить доступ к репозиторию агента

Репозиторий приватный: https://github.com/AILABSCRUME/hermes-agent-vasily

Два варианта:

  • A. Доступ к репозиторию — владелец добавляет вас в Settings → Collaborators. Дальше шаг 3, вариант A.
  • B. Без доступа — владелец передаёт файл vasily-v1.0.0.bundle. Дальше шаг 3, вариант B.

3. Установить агента

Вариант A — из репозитория (рекомендуется, потом обновляется одной командой)

hermes profile install github.com/AILABSCRUME/hermes-agent-vasily --alias --yes

Вариант B — из файла-бандла (без доступа к репозиторию)

Положить vasily-v1.0.0.bundle в любую папку и выполнить:

cd $env:USERPROFILE\Downloads
git clone vasily-v1.0.0.bundle vasily-dist
hermes profile install .\vasily-dist --yes

В обоих случаях в конце появится:

✓ Installed 'vasily' v1.0.0
  Profile path: C:\Users\<вы>\AppData\Local\hermes\profiles\vasily
  Next: copy .env.EXAMPLE to .env and fill in required keys

4. Вписать свой ключ Polza.ai — обязательный шаг

Где взять ключ: https://polza.ai/dashboard/api-keys (личный кабинет Polza.ai → API-ключи → создать). Там же пополнить баланс — расход идёт с вашего счёта.

Куда вписать: файл .env в папке профиля. После установки рядом лежит шаблон .env.EXAMPLE:

cd $env:LOCALAPPDATA\hermes\profiles\vasily
copy .env.EXAMPLE .env
notepad .env

В открывшемся файле — одна строка, вписать ключ после знака =, без кавычек и пробелов:

HERMES_CUSTOM_POLZA_AI_API_KEY=ваш_ключ

Ключ в config.yaml не вписывать — там только имя переменной (key_env: HERMES_CUSTOM_POLZA_AI_API_KEY). Так ключ не уедет в репозиторий и не потеряется при обновлении.

Проверить, что Hermes видит файл:

hermes -p vasily config env-path

Должен вернуться путь ...\profiles\vasily\.env.


5. Запустить

hermes -p vasily chat

Либо короткой командой, если при установке был флаг --alias:

vasily chat

На Windows обёртка vasily.bat создаётся в C:\Users\<вы>\.local\bin. Если команда vasily не находится — эта папка не в PATH; добавьте её либо пользуйтесь полной формой hermes -p vasily chat.

Первое сообщение для проверки: Как тебя зовут и кому ты помогаешь? Ответ должен быть про Dionis и вас.


6. Что где менять под себя

Что Файл Как правильно
Имя владельца, персона, тон %LOCALAPPDATA%\hermes\profiles\vasily\SOUL.md открыть в редакторе, править текст
Модель config.yaml только через hermes -p vasily config set model.default <модель> — правка файла руками ломает конфиг
Список моделей config.yaml hermes -p vasily model (интерактивный выбор)
Ключ API .env правка строки HERMES_CUSTOM_POLZA_AI_API_KEY=
Память о вас — набирается в чате само; чистится через /memory в чате

SOUL.md — единственный файл, который стоит править текстом. Всё остальное — командами.


7. Обновление агента

Когда выходит новая версия (только для варианта A):

hermes profile update vasily

Обновляются SOUL.md, config.yaml, skills/, distribution.yaml. Не трогаются: .env с ключом, память, история сессий, ваши правки config.yaml (сбросить его к версии из репозитория — hermes profile update vasily --force-config).

Посмотреть, что стоит:

hermes profile info vasily
hermes profile list

8. Чего в комплекте нет — настроить самому (по желанию)

Возможность Команда / где
MCP-серверы (внешние инструменты) hermes -p vasily mcp catalog, затем hermes -p vasily mcp add
Мессенджеры (Telegram и др.) hermes -p vasily gateway setup, затем hermes -p vasily gateway start
Задачи по расписанию hermes -p vasily cron add или через десктоп-приложение
Графическое приложение hermes desktop (общее для всех профилей, профиль выбирается внутри)

Скиллы (58 штук: Word, Excel, PDF, поиск, почта, заметки, карты, код) уже внутри — их доустанавливать не нужно. Свой скилл добавляется командой hermes -p vasily skills install <источник>.


9. Если что-то не работает

Симптом Причина / решение
hermes: command not found терминал не перезапущен после установки Hermes
Profile 'vasily' does not exist агент не установлен — вернуться к шагу 3
Ответы вида «нет доступа к модели», 401 ключ в .env пустой/с опечаткой — проверить строку и hermes -p vasily config env-path
Установка не находит репозиторий репозиторий приватный — нет доступа (шаг 2), либо использовать вариант B
vasily: команда не найдена C:\Users\<вы>\.local\bin не в PATH — использовать hermes -p vasily chat
Общий диагноз hermes -p vasily doctor