No description
a3373f9f76
Прогон на Windows-раннере показал, что причин красного CI больше двух. Четыре падения — не в продукте, а в допущениях тестов, зашитых под Linux. 1. test_a41 читал вывод скрипта в кодировке системы. Скрипт теперь пишет UTF-8, а родитель на Windows читал трубу как cp1252 и разваливался на UnicodeDecodeError, оставляя proc.stdout равным None. Кодировка задана явно с обеих сторон трубы. 2. test_p0_3_stop_running_hub знал только про ветку Linux: os.kill по списку от pgrep. На Windows процессы останавливает taskkill по списку от wmic, os.kill не вызывается — тест падал на пустом списке убитых. Инвариант же один для обеих веток: чужой процесс хаба останавливается, собственный PID не трогается. Теперь он проверяется на обеих. 3-4. Оба теста установки подсовывали bash-скрипт hermes-hub-setup.sh. На Windows выбирается HermesHubSetup.exe, и установка честно отвечала «в релизе не найден подходящий файл обновления для текущей платформы». Установщик теперь берётся под ту систему, на которой идёт прогон. Проверка сообщения об ошибке смотрит на то, назван ли код возврата, а не на склонение: ветки формулируют «код 3» и «кодом 3», инвариант один. Тесты: 755 -> 756 passed, 2 skipped, 4 deselected. ruff check . чисто. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> |
||
|---|---|---|
| .agents/skills/frontend-design | ||
| .github/workflows | ||
| agents | ||
| artifacts | ||
| assets | ||
| benchmarks | ||
| config | ||
| docs | ||
| installer | ||
| launcher | ||
| legacy | ||
| scripts | ||
| src/antigravity_provider | ||
| tests | ||
| .gitattributes | ||
| .gitignore | ||
| a15_web_api_and_linux_port_report.md | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| COCKPIT_TOOLS_ARCHITECTURE_COMPARISON.md | ||
| CODEX_CONTRACT_V11_REPORT.md | ||
| CODEX_MOCKUP_REDESIGN_REPORT.md | ||
| CODEX_UI_REDESIGN_REPORT.md | ||
| LICENSE | ||
| pyproject.toml | ||
| README.md | ||
| uv.lock | ||
Hermes Hub
Multi-Agent & Multi-Provider Control Hub for Hermes Agent
Hermes Hub — централизованная панель управления и отказоустойчивый маршрутизатор запросов (Multi-Provider Router) для Hermes Agent. Объединяет учетные записи различных провайдеров (Google Antigravity, OpenAI Codex, OpenCode Go, DeepSeek) в единую согласованную команду с автоматическим переключением при исчерпании квот (failover) и поддержкой сессионной привязки (Session Affinity).
🌟 Ключевые возможности
- 🖥️ Нативное приложение Windows (CustomTkinter & Brandbook):
- Фирменная дизайн-система Obsidian Forest (
#0F1510,#1A2A1F,#2F4A36,#F7F1E3,#CDAA64). - Мгновенное переключение вкладок (P95 < 200 ms, в среднем ~30 ms).
- Полноценная интеграция с панелью задач Windows через
AppUserModelID(HermesHub.Desktop) и multi-resolution.ico.
- Фирменная дизайн-система Obsidian Forest (
- 👥 Команда агентов (Team View):
- 6 логических ролей («Главный оркестратор», «Кодер», «Ревьюер», «Исследователь», «Тестировщик», «Агент общего назначения»).
- Реальные логотипы провайдеров с динамическим кэшированием.
- Четкое разделение флагов MAIN Hermes Account и Primary Orchestrator.
- 🔀 Многоуровневый Failover & Маршрутизация:
- Визуальные пайплайны маршрутизации со статусами узлов в реальном времени.
- Автоматический failover цепочки
Codex -> Antigravity -> OpenCode Goпри квотных ограничениях (HTTP 429 / Quota Exceeded).
- 🛡️ Строгий Status Resolver & Unified Health:
- Неподключенные слоты отображаются как
NOT_CONFIGURED(«Аккаунт не добавлен») и никогда не показывают ложныхQUOTA_EXHAUSTEDилиHEALTHY. - Автоматическая очистка устаревших квотных записей при удалении credentials.
- Неподключенные слоты отображаются как
- 💼 Cockpit Tools Accounts View:
- Верхний тулбар: Поиск, фильтры (Подключенные, Требуется вход, Квота), сортировка.
- Компактный блок свободных слотов без визуального шума.
- 4-шаговый мастер добавления аккаунтов (Wizard).
- ⚙️ Архитектурные модули (Roadmap P0, P1, P2):
LifecycleSupervisor: Реестр процессов с контролем владения по UUID и PID, исключающий использованиеkillall/taskkill.PolicyEnforcer:WebPolicy(ограничение исходящих доменов, блокировка метаданных) иToolPolicy(валидация команд).UnifiedSkillRegistry: Межпровайдерный реестр навыков.CapabilityMatrix: Ранжирование моделей по контексту, рассуждениям и инструментам.ScheduledTaskSafetyCoordinator: Защита периодических задач (overlap_policy: skip).
- 📦 Windows Installer (
HermesHubSetup.exe):- Обязательная pre-flight проверка наличия установленного Hermes Agent.
- Автоматическое создание ярлыков на Рабочем столе и в Главном меню с
AppUserModelID.
🚀 Быстрый старт
Запуск из исходного кода
# Установка зависимостей
uv sync
# Запуск приложения Hermes Hub
uv run python -m antigravity_provider.router.hermes_hub_app
Запуск тестов и верификации
# Полный набор автоматических тестов (35 тестов)
uv run pytest -v tests/
# Комплексная проверка роутера (10 проверок)
python scripts/verify_multi_provider_router.py
🏗️ Структура проекта
| Каталог | Назначение |
|---|---|
src/antigravity_provider/router/ |
Ядро Multi-Provider Router и Native GUI |
src/antigravity_provider/router/ui/ |
Дизайн-система, компоненты и экраны (Views) |
src/antigravity_provider/router/supervisor/ |
Lifecycle Supervisor и политики безопасности (WebPolicy/ToolPolicy) |
src/antigravity_provider/router/skills/ |
Унифицированный реестр навыков |
src/antigravity_provider/router/capability/ |
Матрица возможностей моделей и DeepSeek адаптер |
src/antigravity_provider/router/scheduler/ |
Координатор безопасности запланированных задач |
assets/ |
Фирменные логотипы, иконки провайдеров и .ico |
installer/ |
Инсталлятор HermesHubSetup.py с проверкой Hermes Agent |
tests/ |
Автоматизированные тесты pytest |
docs/ |
Архитектура, гайдлайны бренда, безопасность и производительность |
📄 Лицензия
MIT License. Hermes Hub is an open-source component of the Hermes Agent ecosystem.