curl install · hermes doctor · модель и gateway · матрица платформ · runbook из 6 шагов
Нужно развернуть Nous Research Hermes Agent в 2026 (~174 тыс. stars на GitHub), но упираетесь в PATH, API Key или молчаливый Telegram? Технический runbook: официальный curl | bash ставит Python 3.11 / Node 22, hermes doctor — 12 проверок, hermes setup настраивает модель и gateway до Telegram 7×24. Внутри: требования к окружению, матрица платформ, runbook из 6 шагов, таблица ошибок — и почему для продакшена лучше аренда Mac Mini M4.
Hermes Agent (Nous Research, MIT) — один из самых обсуждаемых open-source self-evolving AI Agent на GitHub: после класса задач создаются переиспользуемые Skills; по оценкам сообщества token на похожих задачах падает ~на 38 %. Через gateway подключаются Telegram, Discord, Slack и 20+ каналов; поддержаны MCP и бэкенды Claude, OpenRouter, Ollama. Отличие от OpenClaw и LangGraph: межсессионная память (SESSION → MEMORY.md → USER.md) и нативное создание Skills; install.sh работает на VPS за $5 или Mac — но 7×24 и macOS browser Skills зависят от хоста.
Без теории — пять болей установки: hermes: command not found, нет API Key, drift конфига после апдейта, тишина в Telegram-группе, ноутбук с suspend. После установки про память: трёхуровневая память и замеры 7×24.
| Параметр | Минимум | Рекомендация (prod gateway) |
|---|---|---|
| ОС | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+ (Apple Silicon) или Ubuntu 24.04 LTS |
| Python / Node | скрипт ставит 3.11 / 22 | вручную не нужно — ориентир hermes doctor |
| RAM | 4 ГБ (только gateway + cloud API) | 16 ГБ+; локальная модель: 32 ГБ UMA |
| Диск | ~1,5 ГБ (кэш Skills) | 20 ГБ SSD+, запас под FTS5 и логи |
| Сеть | GitHub raw + LLM API | стабильная задержка для IM webhook |
Сначала ставить Python/Node: install.sh через uv ставит Python 3.11, Node 22, ripgrep, ffmpeg — без sudo.
Не перезагрузить shell: PATH не обновлён → command not found; source ~/.zshrc или новый терминал.
Пропустить hermes doctor: 12 проверок ловят API Key, ffmpeg, PATH — экономит ~час против слепого запуска.
Браузер на headless VPS: добавьте --skip-browser, иначе Camoufox может оборвать install.
POC на ноутбуке как prod: sleep MacBook рвёт gateway; Skill compounding требует выделенный хост 7×24.
Одна строка curl | bash — разница в uptime, I/O и нативном macOS-пути. «Установилось» ≠ «подходит для gateway и Skill compounding 7×24». Матрица по данным сообщества и датацентров:
| Платформа | Доступность 7×24 | Skill compounding | Месячные затраты | Сценарий |
|---|---|---|---|---|
| Личный MacBook | ≈ 60 % (sleep при закрытии) | частые обрывы | 0 ₽ железо + высокий риск | только POC / локальный CLI |
| Raspberry Pi 4B 8 ГБ | ≈ 88 % | I/O bottleneck, timeout длинных job | разовая покупка | эксперимент, не prod gateway |
| x86 VPS 4 ГБ | ≈ 99,5 % | стабильно, без macOS Skills | pay-as-you-go | чистая API + Telegram, без browser automation |
| Аренда Mac Mini M4 | SLA ЦОД, ~100 % за 30 дней | UMA + launchd, Skills накапливаются | фиксированная аренда | Telegram 7×24 + Camoufox / локальный Ollama |
Установка ~10 минут; стабильный хост 7×24 решает, compoundят Skills или обнуляются каждую неделю.
Unified Memory M4 делит gateway (~4,2 ГБ по данным сообщества), browser automation и SQLite WAL в одном адресном пространстве; launchd на macOS ближе к официальному test path. Краткий тест: аренда на 1 месяц — см. отчёт за 30 дней.
Шаги для macOS / Linux / WSL2; headless VPS на шаге 1 — --skip-browser. Данные в ~/.hermes/ — бэкап перед апдейтом.
One-click install: официальный скрипт, дождаться установки, затем source ~/.zshrc (Linux: ~/.bashrc).
Health check: hermes doctor — Python, Node, ripgrep, ffmpeg, PATH; hermes --version ≥ v0.14.
Конфиг модели: hermes setup или hermes model; OpenRouter / Anthropic / Nous Portal в ~/.hermes/.env.
CLI smoke: hermes интерактивно, задача с tool call (например, подсчёт файлов) — API должен ответить.
Telegram: BotFather → hermes gateway setup, Telegram, token и TELEGRAM_ALLOWED_USERS; в группах — privacy off, удалить и пригласить бота снова.
Daemon 7×24: hermes gateway install && hermes gateway start; Linux: sudo hermes gateway install --system, macOS — launchd user service.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc hermes doctor hermes setup hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
API Key вручную: hermes config set OPENROUTER_API_KEY sk-or-xxxx или в ~/.hermes/.env. После апдейта missing config: hermes config check && hermes config migrate.
Симптомы часто после «скрипт OK, сервис нет» — идите по таблице; не меняйте модель, каталог и gateway одновременно.
| Ошибка / симптом | Причина | Fix |
|---|---|---|
| hermes: command not found | PATH не обновлён | source ~/.zshrc или новый терминал |
| API key not set | LLM не настроен | hermes model или ~/.hermes/.env |
| Missing config after update | drift после версии | hermes config check && hermes config migrate |
| ModuleNotFoundError: dotenv | системный Python вместо venv | ~/.hermes/hermes-agent/venv/bin/hermes |
| Telegram-группа молчит | privacy mode бота | BotFather Group Privacy off, удалить и пригласить снова |
Hermes подключает любой MCP Server (GitHub, БД, браузер) через mcp_servers в ~/.hermes/config.yaml; headless OAuth: hermes mcp login + SSH tunnel. В prod сначала один канал, потом MCP — проще bisect по логам.
Заметка: Windows — PowerShell install; панель Dashboard /chat требует WSL2 — WSL2 + Linux path совпадает с этим runbook.
~/.hermes/hermes-agent/, PATH через скрипт.hermes doctor — ~12 пунктов (Python 3.11, Node 22, ripgrep, ffmpeg, API Key и др.).Ноутбук и домашний NAS хватит для acceptance install, но слабят Telegram 7×24 (sleep, I/O VPS, нет macOS browser Skills); Pi не тянет локальный 8B и long jobs. Командам, которым Hermes нужен как постоянный коллега, аренда Mac Mini M4 упаковывает uptime, UMA и launchd в предсказуемый OpEx.
Runbook пройден и нужен prod-узел 7×24: VpsMesh — Mac Mini M4 в облаке, SSH, panel ресурсов, бэкап ~/.hermes/ до конца аренды. Тарифы: цены аренды Mac Mini M4, помощь: центр помощи, заказ: оформить заказ.
Важно: не меняйте хост, major-апдейт Hermes и whitelist Telegram в один weekend — сначала hermes gateway status стабилен 24 ч, потом модель или MCP.
Нет. install.sh через uv ставит Python 3.11, Node.js 22, ripgrep и ffmpeg в ~/.hermes/hermes-agent/. Затем source ~/.zshrc и hermes doctor — 12 проверок.
В privacy mode бот в группах отвечает только на /-команды. BotFather → Bot Settings → Group Privacy off, бота удалить и пригласить снова. TELEGRAM_ALLOWED_USERS — ваш ID; hermes gateway status должен быть running.
Cloud API + Telegram: x86 VPS достаточно. macOS browser Skills, локальный Ollama или launchd: аренда Mac Mini M4 — стабильнее uptime и UMA. Тест 1 месяц — страница цен, заказ оформить заказ.