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

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

Агент ставится в единственный профиль Hermes. Переключателей профилей и лишних настроек в сборке нет: получается один помощник и больше ничего.

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

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

Быстрый путь

Шаг 1. Агент

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

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

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

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

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

C:\Hermes

В папке окажется win-unpacked\Hermes.exe — запустите его.

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

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

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

Данные Hermes лежат в %LOCALAPPDATA%\hermes — это и есть дом агента.

Важно. Если здесь уже стоит рабочий агент (своя персона, ключи, память, переписка) — этот комплект ставить нельзя, он рассчитан на единственного агента. setup.cmd это проверит и остановится сам.

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

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

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

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

hermes --version

2. Что вам передаёт владелец

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

3. Установить агента (вручную)

Если не хотите запускать setup.cmd, положите файл, например, в Downloads и откройте PowerShell:

cd $env:USERPROFILE\Downloads
git clone ailab-<версия>.bundle ailab-dist
Remove-Item -Recurse -Force .\ailab-dist\.git

Скопируйте персону, настройки и скиллы в дом агента:

Copy-Item .\ailab-dist\SOUL.md     $env:LOCALAPPDATA\hermes\ -Force
Copy-Item .\ailab-dist\config.yaml $env:LOCALAPPDATA\hermes\ -Force
Copy-Item .\ailab-dist\skills      $env:LOCALAPPDATA\hermes\ -Recurse -Force

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

Проверить, что стало:

hermes doctor

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

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

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

HERMES_CUSTOM_POLZA_AI_API_KEY=ваш_ключ

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

notepad $env:LOCALAPPDATA\hermes\.env

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

hermes config env-path

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

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

5. Запустить

hermes chat

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

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

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

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

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

Вручную, если предпочитаете команды: повторите раздел 3 с новым файлом — три команды Copy-Item перезапишут персону, настройки и скиллы. Ключ и память лежат в других файлах и не трогаются.

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

hermes doctor

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

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

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

10. Установка одной командой (PowerShell)

Если не хочется возиться с распаковкой вручную — откройте PowerShell (обычный, без администратора) и вставьте блок целиком:

$b = 'https://github.com/AILABSCRUME/AI_Lab_SCRUME_Co/releases/download/v1.3.1'
$t = Join-Path $env:TEMP 'ailab'
Invoke-RestMethod "$b/ailab-setup-v1.3.1.zip" -OutFile "$t.zip"
Expand-Archive "$t.zip" $t -Force
& "$t\setup.cmd"

Дальше всё делает установщик: Git, Hermes, агент, Блокнот для ключа, проверка.

Пути собираются через Join-Path намеренно. Строка вида $t="$env:TEMP\ailab" при копировании легко теряет кавычки, и PowerShell падает с Непредвиденная лексема "\ailab". Join-Path таких кавычек не требует.

Приложение (158 МБ) ставится отдельно:

$b = 'https://github.com/AILABSCRUME/AI_Lab_SCRUME_Co/releases/download/v1.3.1'
$z = Join-Path $env:USERPROFILE 'hermes-desktop-scrum.zip'
Invoke-RestMethod "$b/hermes-desktop-scrum.zip" -OutFile $z
Expand-Archive $z 'C:\Hermes' -Force
& 'C:\Hermes\win-unpacked\Hermes.exe'