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

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

Вам передают два архива:

Второй архив нужен, чтобы был графический интерфейс с логотипом. Без него агент работает, но только в командной строке и с обычной заставкой Hermes.

Быстрый путь

Шаг 1. Приложение

Распакуйте hermes-desktop-scrum.zip в постоянную папку, например:

C:\Hermes

В папке окажется win-unpacked\Hermes.exe. Не запускайте пока.

Распаковывать нужно в постоянное место: папку «Загрузки» Windows периодически чистит, и приложение сломается.

Шаг 2. Агент

Распакуйте vasily-setup-v<версия>.zip (например, в Downloads) и запустите setup.cmd двойным кликом. Скрипт сам:

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

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

Шаг 3. Запуск приложения

Запустите Hermes.exe из папки шага 1. Дальше — раздел 6.

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

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-<версия>.bundle vasily-dist
hermes profile install .\vasily-dist --yes

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

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

4. Ключ Polza.ai — обязательный шаг

Ключ вам выдаёт владелец агента. Вписать его нужно один раз.

Как это происходит: установщик откроет файл .env в Блокноте. Впишите ключ после знака =, без кавычек и пробелов, сохраните (Ctrl+S) и закройте Блокнот:

HERMES_CUSTOM_POLZA_AI_API_KEY=ваш_ключ

Если Блокнот закрылся, а ключ вписать не успели — откройте файл вручную:

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

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

hermes -p vasily config env-path

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

Куда ключ не вписывать

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

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. Если что-то не работает