Hermes Hub

Multi-Agent & Multi-Provider Control Hub for Hermes Agent

Hermes Hub — централизованная панель управления и отказоустойчивый маршрутизатор запросов (Multi-Provider Router) для Hermes Agent. Позволяет объединить учетные записи различных провайдеров (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:

# Интерактивный графический мастер:
.\HermesHubSetup.exe

# Автоматический тихий режим:
.\HermesHubSetup.exe /silent

Вариант 2: Установка через 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\	Пользовательские авторизации и настройки

---

🧪 Тестирование и верификация

# Запуск полного набора unit/integration тестов
uv run pytest tests/test_multi_provider_router.py -v

# Запуск скрипта автоматической верификации роутера
python scripts/verify_multi_provider_router.py

---

📄 Лицензия

Проект распространяется под лицензией MIT.