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

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

Быстрый путь: запустить setup.cmd

Если вам передали папку с файлами setup.cmd, setup.ps1 и vasily-<версия>.bundle — просто запустите setup.cmd двойным кликом. Скрипт сам:

1. найдёт рядом файл агента;
2. снимает метку «скачано из интернета» (иначе Windows блокирует запуск);
3. при необходимости поставит Git и Hermes Agent;
4. поставит агента (при повторном запуске — обновит);
5. создаст файл ключа и откроет его в Блокноте — ключ вписываете вы (единственный ручной шаг);
6. проверит, что агент отвечает, и покажет команду запуска.

Windows может один раз спросить подтверждение (SmartScreen) — это нормально. Первый запуск занимает несколько минут, окно закрывать нельзя. Протокол установки сохраняется рядом: setup-log.txt.

Дальше — раздел 5 «Запустить». Остальные разделы нужны, только если что-то пошло не так или вы ставите агента вручную.

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 в ту же папку, где лежит setup.cmd, и снова запустить setup.cmd. Скрипт увидит установленного агента, обновит его и оставит ваш ключ, память и переписку. Прежний бандл можно не удалять — берётся самый свежий по имени.

Вручную, если предпочитаете команды:

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

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

Строка с удалением .git — не украшение: git помечает файлы внутри .git/objects/pack атрибутом «только чтение», и установщик падает с PermissionError: [WinError 5]. Если этой папки нет, строка ничего не делает.

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

hermes profile info vasily
hermes profile list

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

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

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