# Руководство по настройке Hermes Agent

> Направьте пользовательского провайдера Hermes Agent на LLMoxy через ~/.hermes/config.yaml и .env для доступа к полной линейке моделей GPT / Claude / Gemini.

Веб-сайт: [https://hermes-agent.nousresearch.com (нажмите для перехода!)](https://hermes-agent.nousresearch.com)

> **📌 О Hermes Agent**
> Hermes Agent — это открытый терминальный ИИ-агент, запущенный Nous Research, поддерживающий три точки входа CLI / TUI / API Server, и способный подключаться к любой совместимой с OpenAI конечной точке.

## Адрес исходного кода

- GitHub: [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)
- Официальная документация: [hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs)

## 1. Установить Hermes Agent

### Способ 1: Установка pip (рекомендуется)

```bash
pip install hermes-agent
hermes postinstall    # Опционально: автоматическая установка Node.js / браузера / ripgrep / ffmpeg
```

### Способ 2: Установка скриптом (следовать ветке main)

```bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

После установки перезагрузите Shell:

```bash
source ~/.zshrc    # или source ~/.bashrc
```

## 2. Основной процесс настройки

Настройки Hermes Agent сосредоточены в каталоге `~/.hermes/`:

| Файл | Назначение |
| --- | --- |
| `~/.hermes/config.yaml` | Вся несекретная конфигурация: модель, провайдер, терминал, сжатие и т.д. |
| `~/.hermes/.env` | Ключ API и другие конфиденциальные учетные данные |

### 1. Настроить config.yaml (пользовательский провайдер)

Откройте или создайте `~/.hermes/config.yaml`, запишите блок `model` как провайдер `custom` и направьте `base_url` на LLMoxy:

```yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "grok-4.7"
```

Вы также можете использовать запись одним щелчком CLI (автоматически попадает в `config.yaml`):

```bash
hermes config set model.provider custom
hermes config set model.base_url https://llmoxy.com/v1
hermes config set model.model grok-4.7
```

### 2. Настроить .env (записать ключ API)

Запишите токен LLMoxy в `~/.hermes/.env`:

```
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

Или используйте CLI (рекомендуется, автоматически маршрутизирует в `.env` без утечки в YAML):

```bash
hermes config set OPENAI_API_KEY <LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

Замените `<LLMOXY_API_KEY>xxxxxxxxxxxxxxx` на реальный токен, полученный из [Консоли LLMoxy](https://llmoxy.com/).

> **💡 Подсказка**
> Пожалуйста, используйте токен из группы **auto**. Hermes Agent вызывает LLMoxy через протокол OpenAI Chat Completions; `base_url` должен включать `/v1`.

## 3. Быстрая интерактивная настройка (опционально)

Если вы не хотите редактировать YAML вручную, выполните `hermes model` для входа в интерактивный мастер:

```bash
hermes model
```

Выберите по порядку:

1. В опциях провайдера выберите **Custom Endpoint**
2. Base URL введите `https://llmoxy.com/v1`
3. Ключ API вставьте токен LLMoxy
4. Модель введите `grok-4.7`

## 4. Запустить Hermes

```bash
hermes          # Классический CLI
hermes --tui    # Современный TUI интерфейс (рекомендуется)
```

После запуска приветственный баннер отобразит текущую активную модель и провайдера; вы можете ввести тестовый prompt для проверки связи.

## Полный пример конфигурации

```yaml
# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "grok-4.7"
```

```
# ~/.hermes/.env
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

> **💡 Подсказка по правилам именования моделей**
> `grok-4.7` — это стандартный ID модели на LLMoxy, доступный для просмотра в консоли «Список моделей». Другие распространенные:
> - **Серия GPT**: `gpt-6.1-sol`
> - **Серия Claude**: `claude-opus-5-5`, `claude-fable-5-2`

## Приоритет конфигурации

Hermes Agent читает конфигурацию по следующему приоритету (от высокого к низкому):

1. Параметры командной строки
2. `~/.hermes/config.yaml`
3. `~/.hermes/.env`
4. Встроенные значения по умолчанию

После изменения конфигурации нет необходимости перезапускать Hermes; следующая новая сессия автоматически загрузит последний `config.yaml`.

Это markdown-версия страницы https://ru.llmoxy.com/docs/code-tutorials/hermes-agent.
