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

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

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

Данные 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. Что вам передаёт владелец

Один файл: vasily-<версия>.bundle (например vasily-v1.0.1.bundle). Внутри — весь агент с историей версий. Больше ничего не нужно, доступ к репозиторию не требуется.

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

Положить файл, например, в Downloads, открыть PowerShell:

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

В конце появится:

✓ Installed 'vasily' v1.0.1
  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

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

Короткая команда vasily chat вместо длинной — по желанию:

hermes profile alias vasily        # создаёт C:\Users\<вы>\.local\bin\vasily.bat
vasily chat

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

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

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

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

Владелец передаёт новый файл vasily-<новая версия>.bundle. Дальше в PowerShell:

cd $env:USERPROFILE\Downloads
git clone vasily-v1.0.2.bundle vasily-dist-new

# снять флаг «только чтение» с внутренних файлов агента (Windows-особенность git)
powershell -Command "Get-ChildItem -Force -Recurse `"$env:LOCALAPPDATA\hermes\profiles\vasily\.git`" | ForEach-Object { $_.Attributes = 'Normal' }"

hermes profile install .\vasily-dist-new --force --yes

--force перезаписывает файлы агента (SOUL.md, config.yaml, skills/), не трогая ваши .env с ключом, память и историю переписки.

Строка со снятием «только чтение» — не украшение: git кладёт внутренние файлы (…\vasily\.git\objects\pack\*) с атрибутом ReadOnly, а установщик при --force пытается удалить старую копию и падает с PermissionError: [WinError 5]. Если видите эту ошибку — выполните строку с Attributes = 'Normal' и повторите установку.

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

hermes profile info vasily
hermes profile list

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

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

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