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

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

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

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

| Архив | Что внутри | Размер |
|---|---|---|
| `ailab-setup-v<версия>.zip` | агент: персона, настройки, 58 скиллов, установщик | ~1 МБ |
| `hermes-desktop-scrum.zip` | приложение Hermes с фирменным логотипом на пустом чате | ~150 МБ |

Второй архив нужен, чтобы был графический интерфейс с логотипом. Без него агент
работает, но только в командной строке и с обычной заставкой 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. при необходимости ставит переносимый Git (с GitHub, 58 МБ) и Hermes Agent;
   Git кладётся ровно туда, где его ищет официальный установщик Hermes —
   поэтому его стадия `prerequisites` ничего не качает и не падает;
   если Git в системе уже есть, ничего не скачивается;
4. проверяет, что установка свободна, и **останавливается**, если на машине уже работает
   другой агент Hermes — чтобы не потерять чужие данные;
5. ставит агента (при повторном запуске — обновляет);
6. создаёт файл ключа и **открывает его в Блокноте** — впишите туда ключ от владельца;
7. проверяет, что агент отвечает;
8. **готовит окружение** (`hermes pm repair`) — окно приложения поднимает бэкенд и ждёт
   его ответа 15 секунд, а на неподготовленной машине зависимости ставятся минутами;
   поэтому они ставятся заранее. Установка зависимостей идёт с отчётом на экране
   (на медленном интернете это может занять до 10 минут);
9. **готовит движок для окна** — проверяет, что окно поднимет его сразу, и даёт запас
   по времени. Без этого шага окно на холодной машине решало, что движок не работает,
   и само уходило в доустановку, где падало с ошибкой «Отказано в доступе»;
10. **скачивает и ставит окно приложения** (~158 МБ) и кладёт **ярлык «AILab SCRUME Agent»
    на рабочий стол**.

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

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

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

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

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

---

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

| Что | Проверка | Если нет |
|---|---|---|
| Windows 10/11 | — | — |
| Git | `git --version` | не нужен — установщик положит сам |
| Hermes Agent | `hermes --version` | см. раздел 1 (setup.cmd поставит сам) |
| Свой ключ Polza.ai | — | получить у владельца агента |
| Файл агента `ailab-*.bundle` | — | получить у владельца (раздел 2) |

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

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

---

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

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

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

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

```powershell
hermes --version
```

---

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

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

---

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

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

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

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

```powershell
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]`.

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

```powershell
hermes doctor
```

---

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

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

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

```
HERMES_CUSTOM_POLZA_AI_API_KEY=ваш_ключ
```

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

```powershell
notepad $env:LOCALAPPDATA\hermes\.env
```

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

```powershell
hermes config env-path
```

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

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

---

## 5. Запустить

```powershell
hermes chat
```

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

---

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

| Что | Файл | Как правильно |
|---|---|---|
| Имя владельца, персона, тон | `%LOCALAPPDATA%\hermes\SOUL.md` | открыть в редакторе, править текст |
| Модель | `config.yaml` | только через `hermes config set model.default <модель>` — правка файла руками ломает конфиг |
| Список моделей | `config.yaml` | `hermes model` (интерактивный выбор) |
| Ключ API | `.env` | правка строки `HERMES_CUSTOM_POLZA_AI_API_KEY=` |
| Память о вас | — | набирается в чате само; чистится через `/memory` в чате |

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

---

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

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

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

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

```powershell
hermes doctor
```

---

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

| Возможность | Команда / где |
|---|---|
| MCP-серверы (внешние инструменты) | `hermes mcp catalog`, затем `hermes mcp add` |
| Мессенджеры (Telegram и др.) | `hermes gateway setup`, затем `hermes gateway start` |
| Задачи по расписанию | `hermes cron add` или через десктоп-приложение |
| Графическое приложение | `Hermes.exe` (из распакованного архива) |

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

---

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

| Симптом | Причина / решение |
|---|---|
| Установка остановилась с перечнем чужих данных | на машине уже работает другой агент — ставить нельзя, данные сохранены |
| `hermes: command not found` | терминал не перезапущен после установки Hermes |
| Ответы вида «нет доступа к модели», 401 | ключ в `.env` пустой/с опечаткой — проверить строку и `hermes config env-path` |
| Установка не находит файл агента | файл не рядом со скриптом — положить `setup.cmd` и `ailab-*.bundle` в одну папку |
| `PermissionError: [WinError 5]` при установке вручную | удалить папку `.git` в распакованном дистрибутиве (раздел 3) |
| `WinError 32` — файл занят другим процессом | запущено приложение Hermes: значок в трее → Выход, затем запустить `setup.cmd` снова |
| Установка идёт слишком долго | первый запуск качает Python, Node и зависимости — это минуты, не ошибка |
| Общий диагноз | `hermes doctor` |

---

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

Откройте 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`.