diff --git a/INSTALL.md b/INSTALL.md index 2a9d7c5..b673430 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,7 +1,7 @@ # Инструкция по установке -Агент **Dionis** — профиль Hermes Agent: личный помощник. Ставится одной командой, -ключ API у каждого свой. +Агент **Dionis** — профиль Hermes Agent: личный помощник. Ставится одной командой из +файла, который передал вам владелец. Ключ API у каждого свой. --- @@ -13,6 +13,7 @@ | Git | `git --version` | `winget install Git.Git` | | Hermes Agent | `hermes --version` | см. шаг 1 | | Свой ключ Polza.ai | — | см. шаг 4 | +| Файл агента `vasily-*.bundle` | — | получить у владельца (шаг 2) | Данные Hermes лежат в `%LOCALAPPDATA%\hermes`. Агент встанет в `%LOCALAPPDATA%\hermes\profiles\vasily`. @@ -36,41 +37,28 @@ --- -## 2. Получить доступ к репозиторию агента +## 2. Что вам передаёт владелец -Репозиторий приватный: https://github.com/AILABSCRUME/hermes-agent-vasily - -Два варианта: - -- **A. Доступ к репозиторию** — владелец добавляет вас в - Settings → Collaborators. Дальше шаг 3, вариант A. -- **B. Без доступа** — владелец передаёт файл-бандл `vasily-<версия>.bundle` - (например, `vasily-v1.0.1.bundle`). Дальше шаг 3, вариант B. +Один файл: **`vasily-<версия>.bundle`** (например `vasily-v1.0.1.bundle`). +Внутри — весь агент с историей версий. Больше ничего не нужно, доступ к репозиторию +не требуется. --- ## 3. Установить агента -### Вариант A — из репозитория (рекомендуется, потом обновляется одной командой) - -```powershell -hermes profile install github.com/AILABSCRUME/hermes-agent-vasily --alias --yes -``` - -### Вариант B — из файла-бандла (без доступа к репозиторию) - -Положить `vasily-v1.0.0.bundle` в любую папку и выполнить: +Положить файл, например, в `Downloads`, открыть PowerShell: ```powershell cd $env:USERPROFILE\Downloads -git clone vasily-v1.0.0.bundle vasily-dist +git clone vasily-v1.0.1.bundle vasily-dist hermes profile install .\vasily-dist --yes ``` -В обоих случаях в конце появится: +В конце появится: ``` -✓ Installed 'vasily' v1.0.0 +✓ 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 ``` @@ -117,19 +105,20 @@ hermes -p vasily chat ``` -Либо короткой командой, если при установке был флаг `--alias`: +Первое сообщение для проверки: `Как тебя зовут и кому ты помогаешь?` +Ответ должен быть про Dionis и вас. + +Короткая команда `vasily chat` вместо длинной — по желанию: ```powershell +hermes profile alias vasily # создаёт C:\Users\<вы>\.local\bin\vasily.bat vasily chat ``` -> На Windows обёртка `vasily.bat` создаётся в `C:\Users\<вы>\.local\bin`. -> Если команда `vasily` не находится — эта папка не в PATH; добавьте её либо +> На Windows обёртка кладётся в `C:\Users\<вы>\.local\bin`, а этой папки нет в PATH — +> в новом терминале команда `vasily` не найдётся. Либо добавьте папку в PATH, либо > пользуйтесь полной формой `hermes -p vasily chat`. -Первое сообщение для проверки: `Как тебя зовут и кому ты помогаешь?` -Ответ должен быть про Dionis и вас. - --- ## 6. Что где менять под себя @@ -148,15 +137,16 @@ ## 7. Обновление агента -Когда выходит новая версия (только для варианта A): +Владелец передаёт новый файл `vasily-<новая версия>.bundle`. Дальше: ```powershell -hermes profile update vasily +cd $env:USERPROFILE\Downloads +git clone vasily-v1.0.2.bundle vasily-dist-new +hermes profile install .\vasily-dist-new --force ``` -Обновляются `SOUL.md`, `config.yaml`, `skills/`, `distribution.yaml`. -**Не трогаются:** `.env` с ключом, память, история сессий, ваши правки `config.yaml` -(сбросить его к версии из репозитория — `hermes profile update vasily --force-config`). +`--force` перезаписывает файлы агента (`SOUL.md`, `config.yaml`, `skills/`), +**не трогая** ваши `.env` с ключом, память и историю переписки. Посмотреть, что стоит: @@ -189,6 +179,6 @@ | `hermes: command not found` | терминал не перезапущен после установки Hermes | | `Profile 'vasily' does not exist` | агент не установлен — вернуться к шагу 3 | | Ответы вида «нет доступа к модели», 401 | ключ в `.env` пустой/с опечаткой — проверить строку и `hermes -p vasily config env-path` | -| Установка не находит репозиторий | репозиторий приватный — нет доступа (шаг 2), либо использовать вариант B | +| Установка не находит файл агента | файл не в текущем каталоге — проверить `cd $env:USERPROFILE\Downloads` и имя файла | | `vasily: команда не найдена` | `C:\Users\<вы>\.local\bin` не в PATH — использовать `hermes -p vasily chat` | | Общий диагноз | `hermes -p vasily doctor` | diff --git a/README.md b/README.md index 9111bc3..40d856e 100644 --- a/README.md +++ b/README.md @@ -1,42 +1,27 @@ # Dionis — агент для Василия -Профиль Hermes Agent: личный помощник руководителя. Персона, базовый конфиг, набор скиллов. +Профиль Hermes Agent: личный помощник руководителя. Персона, базовый конфиг, 58 скиллов. +Автор: AI laboratory SCRUM company. -## Установка +**Получателю агента:** пошаговая инструкция — [`INSTALL.md`](INSTALL.md). Агент +передаётся файлом `vasily-<версия>.bundle`; доступ к репозиторию не нужен. -Полная пошаговая инструкция — в файле [`INSTALL.md`](INSTALL.md): что поставить, -откуда взять ключ, что и где менять. - -Коротко: - -```bash -hermes profile install <адрес этого репозитория> --alias --yes -``` - -Дальше: - -1. Профиль попросит ключ API. Ключ свой, отдельный — авторский сюда не входит. - После установки рядом появится `.env.EXAMPLE`; скопируй в `.env` и впиши ключ: - - ``` - cp ~/.hermes/profiles/vasily/.env.EXAMPLE ~/.hermes/profiles/vasily/.env - # отредактируй: HERMES_CUSTOM_POLZA_AI_API_KEY=<свой ключ> - ``` - -2. Запуск: `vasily chat` (или `hermes -p vasily chat`). +**Автору:** это исходник дистрибутива. ## Что внутри | Путь | Что это | |---|---| -| `distribution.yaml` | манифест: имя, версия, требуемые переменные окружения | +| `distribution.yaml` | манифест: имя, версия, автор, требуемые переменные окружения | | `SOUL.md` | персона агента (правится под владельца) | | `config.yaml` | модель, провайдер (Polza.ai), инструменты, язык — **без ключей** | | `skills/` | 58 штатных скиллов Hermes (документы, таблицы, PDF, поиск, почта, заметки, код) | +| `INSTALL.md` | пошаговая инструкция для получателя | | `.env.template` | шаблон `.env`, устанавливается как `.env.EXAMPLE` | -Ключ API живёт только в `.env` и в репозиторий не попадает: в `config.yaml` стоит -`key_env: HERMES_CUSTOM_POLZA_AI_API_KEY`, то есть имя переменной, а не значение. +Ключ API живёт только в `.env` получателя: в `config.yaml` стоит +`key_env: HERMES_CUSTOM_POLZA_AI_API_KEY` — имя переменной, а не значение. +В репозитории ключей нет. ## Что не входит @@ -44,15 +29,36 @@ - MCP-серверы (Revit, AutoCAD и прочее) — не подключены, ставятся отдельно под свои задачи. - SSH-бэкенд, cron-задачи, память и история автора. -## Обновление +## Передать получателю (файлом) ```bash -hermes profile update vasily +cd <этот каталог> +git bundle create ../vasily-<версия>.bundle --all +git bundle verify ../vasily-<версия>.bundle # ожидается «is okay» + «complete history» ``` -Обновляются `SOUL.md`, `config.yaml`, `skills/`. Файлы пользователя (`.env`, память, -история, сессии) не трогаются. Если `config.yaml` правился локально, он сохраняется — -сбросить к версии из репозитория можно флагом `--force-config`. +Получатель разворачивает бандл по `INSTALL.md` (шаг 3). + +## Обновить агента у получателя + +Поднять версию в `distribution.yaml`, закоммитить, создать новый бандл и передать файл. +Получатель ставит его с флагом `--force` (шаг 7 в `INSTALL.md`): файлы агента +перезаписываются, `.env` с ключом, память и история остаются. + +## Проверка перед передачей + +```bash +hermes profile install <этот каталог> --name vasily-test --yes +hermes profile info vasily-test # версия, источник, требуемая переменная +hermes -p vasily-test chat -q "Назови себя и кому помогаешь." +hermes profile delete vasily-test -y # на Windows сначала: hermes -p default gateway stop +``` + +Публикация в git-репозиторий (если нужен вариант A — обновление одной командой): + +```bash +git tag v<версия> && git push origin master --tags +``` ## MCP (по желанию) diff --git a/distribution.yaml b/distribution.yaml index 76b16fb..44d74bf 100644 --- a/distribution.yaml +++ b/distribution.yaml @@ -1,8 +1,8 @@ name: vasily -version: 1.0.1 +version: 1.1.0 description: "Личный помощник руководителя: документы, письма, договоры, расчёты, поиск, задачи." hermes_requires: ">=0.21.6" -author: "Oleg" +author: "AI laboratory SCRUM company" license: "MIT" env_requires: