67 lines
4.1 KiB
Markdown
67 lines
4.1 KiB
Markdown
# Hermes Hub
|
||
|
||
**Multi-Agent & Multi-Provider Control Hub for Hermes Agent**
|
||
|
||
Hermes Hub — централизованная панель управления и отказоустойчивый маршрутизатор запросов (Multi-Provider Router) для [Hermes Agent](https://hermes-agent.org/). Позволяет объединить учетные записи различных провайдеров (**OpenAI Codex**, **Google Antigravity**, **OpenCode Go**) в единую отказоустойчивую команду с автоматическим переключением при исчерпании квот (failover) и поддержкой диалогового контекста (Session Affinity).
|
||
|
||
---
|
||
|
||
## 🌟 Ключевые возможности
|
||
|
||
- 👥 **Визуальная панель «Команда Hermes»**: Управление ролями агентов («Главный оркестратор», «Кодер 1», «Кодер 2», «Ревьюер», «Исследователь», «Быстрый агент», «Резерв»).
|
||
- 🔀 **Многоуровневый Failover**: Бесшовное переключение цепочки провайдеров `Codex -> Antigravity -> OpenCode Go` при квотных ограничениях (HTTP 429 / Quota Exceeded).
|
||
- 🧠 **Auto Assignment Engine**: Автоматический подбор свободных слотов при подключении новых аккаунтов и защита от дубликатов.
|
||
- ⚡ **Session Affinity**: Сохранение используемого профиля и модели на протяжении диалоговой сессии без случайных скачков контекста.
|
||
- 🔐 **Безопасная изоляция профилей**: Раздельные профили окружения и хранилища учетных данных (`auth.json`), маскирование email и API-ключей.
|
||
- 💻 **Нативный лаунчер (`HermesHub.exe`)**: Windows App Mode на базе Microsoft Edge с проверкой готовности бэкенда (HTTP 200 health check gate).
|
||
- 📦 **Полноценный Windows Installer (`HermesHubSetup.exe`)**: Мастер установки с pre-flight проверкой Hermes 0.20.4+, тихим режимом `/silent`, поддержкой обновления и безопасного удаления.
|
||
|
||
---
|
||
|
||
## 🚀 Быстрый старт
|
||
|
||
### Вариант 1: Установка через Windows Installer
|
||
Скачайте и запустите `HermesHubSetup.exe`:
|
||
```powershell
|
||
# Интерактивный графический мастер:
|
||
.\HermesHubSetup.exe
|
||
|
||
# Автоматический тихий режим:
|
||
.\HermesHubSetup.exe /silent
|
||
```
|
||
|
||
### Вариант 2: Установка через PowerShell
|
||
```powershell
|
||
.\scripts\install.ps1
|
||
```
|
||
|
||
После установки ярлык **Hermes Hub** появится в меню «Пуск».
|
||
|
||
---
|
||
|
||
## 🏗️ Архитектура системы
|
||
|
||
| Компонент | Расположение | Назначение |
|
||
|---|---|---|
|
||
| **Source of Truth** | `E:\Agent projects\hermes-hub` | Репозиторий исходного кода |
|
||
| **Installed Application** | `%LOCALAPPDATA%\Programs\HermesHub\` | Исполняемые файлы (`HermesHub.exe`, скрипты) |
|
||
| **Plugin Integration** | `%LOCALAPPDATA%\hermes\plugins\antigravity-provider\` | Пакет роутера и адаптеров провайдеров |
|
||
| **User Runtime & Auth** | `%LOCALAPPDATA%\hermes\` | Пользовательские авторизации и настройки |
|
||
|
||
---
|
||
|
||
## 🧪 Тестирование и верификация
|
||
|
||
```powershell
|
||
# Запуск полного набора unit/integration тестов
|
||
uv run pytest tests/test_multi_provider_router.py -v
|
||
|
||
# Запуск скрипта автоматической верификации роутера
|
||
python scripts/verify_multi_provider_router.py
|
||
```
|
||
|
||
---
|
||
|
||
## 📄 Лицензия
|
||
|
||
Проект распространяется под лицензией [MIT](LICENSE).
|