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

⛔ НЕ запускайте установку «от имени администратора»

Откройте обычное окно PowerShell. Не «Запуск от имени администратора».

Запуск с повышением прав — главная причина отказа: папки в доме агента создаются от другой учётной записи, и потом движок не может прочитать свой собственный Python. Установка встаёт мгновенно с Access is denied, ещё до любой загрузки. Подробно — раздел «Если установка остановилась» ниже.

От администратора запускается только FIX.cmd (или WIPE.cmd) — и только если установка уже остановилась.

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

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

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

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

Быстрый путь

Одна команда — и всё готово

Вставьте в PowerShell (Win+R → powershell), целиком, одной строкой:

cd $env:TEMP; Remove-Item -Recurse -Force ailab -ErrorAction SilentlyContinue; Remove-Item -Force ailab.zip -ErrorAction SilentlyContinue; curl.exe -L --fail -o ailab.zip "https://github.com/AILABSCRUME/AI_Lab_SCRUME_Co/releases/latest/download/agent-setup.zip"; if ((Get-Item ailab.zip).Length -lt 1MB) { throw "Архив не скачался - повторите (VPN?)" }; Expand-Archive ailab.zip ailab -Force; .\ailab\setup.cmd

Установщик сам делает всё по порядку:

1. находит рядом файл агента;
2. снимает метку «скачано из интернета» (иначе Windows блокирует запуск);
3. проверяет, что установка свободна, и останавливается, если на машине уже работает другой агент Hermes — чтобы не потерять чужие данные. Проверка идёт до первой записи: при чужом агенте в доме не появляется ни одного файла;
4. при необходимости ставит переносимый Git (с GitHub, 58 МБ) и Hermes Agent; Git кладётся ровно туда, где его ищет официальный установщик Hermes — поэтому его стадия prerequisites ничего не качает и не падает; если Git в системе уже есть, ничего не скачивается;
5. ставит агента (при повторном запуске — обновляет);
6. создаёт файл ключа и открывает его в Блокноте — впишите туда ключ от владельца;
7. проверяет, что агент отвечает;
8. готовит окружение (hermes pm repair) — окно приложения поднимает бэкенд и ждёт его ответа считаные секунды, а на неподготовленной машине зависимости ставятся минутами; поэтому они ставятся заранее. Установка зависимостей идёт с отчётом на экране (на медленном интернете это может занять до 10 минут); 8b. готовит движок для окна — проверяет, что окно поднимет его сразу, и даёт запас по времени. Без этого шага окно на холодной машине решало, что движок не работает, и само уходило в доустановку, где падало с ошибкой «Отказано в доступе»;
9. скачивает и ставит окно приложения (~158 МБ) и кладёт ярлык «AILab SCRUME Agent» на рабочий стол.

Запускайте установку обычным пользователем — НЕ «от имени администратора». Это главная причина отказа: папки в доме агента уходят другой учётной записи, и потом ни движок, ни pm repair не могут прочитать свой собственный Python. Подробности — в разделе «Если установка остановилась».

Больше ничего делать не нужно: после установки запускайте агента ярлыком с рабочего стола.

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

Если качать архивом вручную

1. Скачайте agent-setup.zip (в релизе он же ailab-setup-v<версия>.zip), распакуйте в пустую папку, запустите setup.cmd двойным кликом — дальше как выше (шаги 1–9 делает скрипт).
2. Отдельно качать hermes-desktop-scrum.zip не нужно — установщик сам его скачает и поставит. Этот архив нужен, только если на машине нет интернета или хочется поставить приложение вручную: тогда распакуйте его в постоянную папку (например C:\Hermes), запустите Hermes.exe, затем make-shortcut.cmd.

Приложение ставится в %LOCALAPPDATA%\AILabSCRUME\App. Ярлык ведёт на неё — папку не удаляйте и не переносите. В «Загрузки» распаковывать нельзя: Windows их периодически чистит, и приложение сломается. Остальные разделы нужны, только если что-то пошло не так или вы ставите агента вручную.

Если установка остановилась

Рядом с setup.cmd (в той же распакованной папке) лежат файлы помощи. Запускаются двойным кликом — вводить команды не нужно:

CHK и ACL ничего не меняют — их можно запускать в любой момент.

Запуск от администратора: правой кнопкой по файлу → «Запуск от имени администратора». Установку (setup.cmd) так запускать НЕЛЬЗЯ — только файлы починки.

Симптом: «Отказано в доступе» или «движок не запускается»

Причина — права, а не сеть. Папки внутри %LOCALAPPDATA%\hermes\tools принадлежат другой учётной записи: сама папка «видна», а войти внутрь нельзя. Движок не находит свой Python и падает мгновенно, ещё до любой загрузки.

Признак: установка встаёт сразу, с сообщением Access is denied, без попыток что-то скачать.

Лечение: запустите FIX.cmd от администратора и дождитесь окончания (несколько минут), затем запустите setup.cmd обычным пользователем.

Такое состояние создаёт запуск установки от администратора. Если один раз так вышло — больше не повышайте права для установки.

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-v<версия>.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 (обычный, без администратора) и вставьте целиком, одной строкой:

cd $env:TEMP; Remove-Item -Recurse -Force ailab -ErrorAction SilentlyContinue; Remove-Item -Force ailab.zip -ErrorAction SilentlyContinue; curl.exe -L --fail -o ailab.zip "https://github.com/AILABSCRUME/AI_Lab_SCRUME_Co/releases/latest/download/agent-setup.zip"; if ((Get-Item ailab.zip).Length -lt 1MB) { throw "Архив не скачался - повторите (VPN?)" }; Expand-Archive ailab.zip ailab -Force; .\ailab\setup.cmd

Установщик делает всё сам: Git, Hermes, агент, Блокнот для ключа, проверка, скачивание и установка окна приложения, ярлык на рабочем столе. Второй команды не требуется.

Ссылка releases/latest/download/... всегда указывает на последний выпуск — при выходе новой версии команду менять не нужно.

Строка дана одной строкой с ; намеренно: многострочный блок при копировании из письма или мессенджера легко приезжает побитым (пустые $b/$t, ошибка Непредвиденная лексема "\ailab"). Каждую часть можно выполнить и по отдельности — результат тот же.

Приложение качать отдельно не нужно. Если же интернета нет или приложение хочется поставить вручную — распакуйте hermes-desktop-scrum.zip в постоянную папку (например C:\Hermes), запустите Hermes.exe, затем make-shortcut.cmd.