Hermes Agent + DeepSeek у мережі Gonka — автономний агент за копійки

Встановлення Hermes (Linux, macOS, WSL2). Офіційний інсталятор сам підтягне Python, Node.js, ripgrep і ffmpeg:

# Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Windows (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Після встановлення перезавантажте шел і перевірте запуск:

source ~/.bashrc   # or ~/.zshrc
hermes             # interactive CLI

API-ключ JoinGonka: якщо його ще немає — зареєструйтеся на gate.joingonka.ai/register, підтвердьте адресу — на рахунок надійдуть 3M безкоштовних токенів — і створіть ключ із префіксом jg- у Dashboard. Один ключ і один баланс працюють одразу для всіх моделей.

Hermes працює з будь-яким OpenAI-сумісним endpoint: якщо сервер відповідає на /v1/chat/completions — Hermes можна на нього спрямувати. Gateway JoinGonka саме такий. Є три способи налаштування.

Спосіб 1: наш інсталятор (одна команда, рекомендовано). Пропише провайдера в конфіг Hermes, встановить DeepSeek V4 Flash моделлю за замовчуванням і живим запитом перевірить, що гейт приймає ключ і модель:

npx @joingonka/setup --tool hermes

Спосіб 2: майстер налаштування. Запустіть у терміналі поза активною сесією:

hermes model

У списку провайдерів виберіть «Custom endpoint (self-hosted / VLLM / etc.)» і введіть три значення:

• API base URL: https://gate.joingonka.ai/v1
• API key: jg-your-key
• Model name: deepseek-ai/DeepSeek-V4-Flash-0731

Спосіб 3: редагування конфігу. Hermes зберігає налаштування моделей у ~/.hermes/config.yaml (у нативній збірці для Windows — %LOCALAPPDATA%\hermes\config.yaml) — це єдине джерело істини. Додайте секцію:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: deepseek-ai/DeepSeek-V4-Flash-0731
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-your-key

Ім'я моделі пишеться в ключ default — це канонічний ключ Hermes. Рядок model: всередині блоку — лише запасний псевдонім: він не діє, якщо default вже задано (наприклад, майстром налаштування), тому при ручному редагуванні змінюйте саме default.

⚠️ Ключ — тільки в model.api_key. Документація Hermes допускає OPENAI_API_KEY у ~/.hermes/.env, але для кастомного endpoint це не працює: Hermes читає ключ тільки з model.api_key, і з ключем у .env гейт відповість 401 Invalid API key. Перевірено на Hermes v0.20.4.

Перевірка: запустіть hermes і напишіть «Створи файл hello.py з функцією hello world». Агент має створити файл і показати результат. Стан поточної конфігурації видно через hermes config show | grep '^model\.' і hermes status.

Перемикання на льоту: всередині сесії командою /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. А /model custom без імені сам підтягне модель з endpoint, якщо вона там одна.

Hermes — агентний інструмент з пам'яттю та навичками. Він не відповідає однією реплікою: читає файли, пише код, запускає команди, стискає контекст, веде довгі фонові завдання через планувальник. Кожна дія — це API-виклик, і за день автономної роботи накопичуються десятки мільйонів токенів. Порівняємо вартість типових сесій:

З JoinGonka Gateway Hermes можна тримати запущеним цілодобово: нічні звіти, щотижневі аудити, фонові завдання через cron-планувальник — без огляду на рахунок. На цінах Anthropic кожен такий запуск довелося б рахувати вручну. Стартового балансу при реєстрації вистачає, щоб прогнати агента на реальному завданні і побачити власний розхід до першого поповнення.

Через Gateway користувачеві відразу доступні три моделі Gonka — всі вони підтримують нативний tool calling (OpenAI function calling), тому навички та інструменти Hermes працюють надійно, без парсингу текстових відповідей:

Про ліміти токенів у Hermes. У config.yaml поле context_length — це повне контекстне вікно (вхід + вихід), а max_tokens — стеля тільки на довжину відповіді. Обидва краще не задавати: Hermes сам визначить коректні значення від провайдера. Якщо задаєте max_tokens вручну, тримайте його в межах моделі: через Gateway це 32768 у DeepSeek V4 Flash та 8192 у MiniMax M2.7 та GLM-5.3 Flash. Змінити модель у будь-який момент можна командою hermes model або прямо в сесії через /model.

Схожі термінальні інструменти в нашій базі знань: Claude Code, Cline.