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.

4.1 KiB Raw Blame History Unescape Escape