---
title: "Установка Hermes Agent"
---

# Установка Hermes Agent

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

[Hermes Agent](https://hermes-agent.nousresearch.com/) — это self-hosted AI-агент от Nous Research. Он работает на вашем сервере, взаимодействует с файлами и инструментами, выполняет команды в терминале и сохраняет историю сессий. Общаться с агентом можно через текстовый интерфейс в терминале.

В Timeweb Cloud доступен готовый образ с установленным Hermes. После создания сервера останется подключить к нему AI-агента или AI Gateway.

## Создание сервера

1.  В панели управления перейдите в раздел «[Облачные серверы](https://timeweb.cloud/my/cloud/servers)».
    
2.  Нажмите «Создать» или «Добавить».
    
3.  На вкладке «Маркетплейс» перейдите в раздел «AI» и выберите образ «Hermes».
    
4.  Выберите регион и конфигурацию сервера, настройте остальные параметры.
    
5.  Нажмите «Заказать», чтобы создать сервер.
    

![Установка Hermes](https://content.timeweb.com/assets/e31c92a8-2096-4f65-8cf8-89d38b09502d.png?width=2126&height=1600)

Hermes и необходимые для его работы компоненты будут установлены автоматически при создании сервера.

## Выбор способа подключения

К Hermes вы можете подключить AI-агента или AI Gateway.

Если подключить AI-агента, можно использовать [базу знаний](https://timeweb.cloud/docs/ai-agents/manage-knowledge-bases). Hermes будет работать с одной моделью — той, которая выбрана в настройках агента. Чтобы сменить ее, измените модель в панели управления Timeweb Cloud.

Если подключить AI Gateway, использовать базы знаний AI-агентов не получится. Зато в Hermes можно выбрать любую доступную в AI Gateway модель и переключать модели во время работы.

Перед началом настройки подготовьте параметры подключения.

### Для AI-агента

Понадобятся:

-   [Базовый URL агента](https://timeweb.cloud/docs/ai-agents/api-usage/openai-compatible-api#bazovyj-url). Он отображается на вкладке «Дашборд» в панели управления агентом.
    
-   [Ключ доступа](https://timeweb.cloud/docs/ai-agents/manage-agents/api-access-key).
    

Если AI-агент еще не создан, воспользуйтесь [инструкцией](https://timeweb.cloud/docs/ai-agents/manage-agents/create).

### Для AI Gateway

Понадобятся:

-   Базовый URL: `https://api.timeweb.ai/v1`.
    
-   [API-ключ AI Gateway](https://timeweb.cloud/docs/ai-agents/api-usage/ai-gateway#sozdanie-api-klucha).
    

AI Gateway использует отдельные ключи, не связанные с ключами AI-агентов.

## Настройка подключения

Подключитесь к серверу по SSH с вашего компьютера.

Если используете macOS или Linux, откройте терминал, на Windows — PowerShell. В панели управления сервером перейдите на вкладку «Дашборд» и скопируйте команду из блока «Подключение по SSH». Вставьте ее в терминал и нажмите `Enter`.

![Данные для подключения к серверу](https://content.timeweb.com/assets/3c2b9758-9ed4-4040-ab5a-718271544b4b.png?width=2172&height=1952)

При первом подключении появится запрос на добавление сервера в список доверенных:

```bash
Are you sure you want to continue connecting (yes/no/[fingerprint])?
```

Введите `yes` и нажмите `Enter`, затем введите root-пароль из панели управления. При вводе пароль не отображается — это нормальное поведение терминала.

После подключения автоматически откроется текстовый интерфейс Hermes. Вернитесь в командную строку, нажав `Ctrl+C`.

Запустите скрипт настройки:

```bash
curl -fsSL https://st.timeweb.com/cloud-static/twc-hermes-autoinstall.sh -o /tmp/twc-hermes-autoinstall.sh && bash /tmp/twc-hermes-autoinstall.sh
```

Скрипт запросит:

1.  `Base URL` — базовый URL AI-агента или AI Gateway.
    
2.  `API Key` — соответствующий ключ доступа.
    

После ввода параметров скрипт проверит подключение и выведет выбранную конфигурацию. Проверьте значения. Если все указано правильно, введите `y` и нажмите `Enter`.

![Настройка провайдера в Hermes](https://content.timeweb.com/assets/a0c621d2-c5ea-4aea-9a19-1c368e83acff.png?width=1642&height=544)

Скрипт добавит провайдера `twc-agent` и откроет интерфейс чата.

## Выбор модели в AI Gateway

Этот шаг требуется только при подключении через AI Gateway. При использовании AI-агента Hermes обращается к модели, выбранной в настройках агента.

В интерфейсе Hermes выполните команду:

```bash
/model
```

Откроется окно выбора модели. Выберите провайдера `twc-agent`, затем — модель, которую хотите использовать.

![Выбор модели в Hermes](https://content.timeweb.com/assets/184cd3b6-1c65-42b2-8f37-caf431a7412a.png?width=2326&height=1202)

_Интерфейс [Hermes Agent](https://hermes-agent.nousresearch.com/)_

Модель можно изменить во время работы той же командой `/model`.

## Работа с Hermes

Чтобы вручную запустить текстовый интерфейс Hermes, выполните:

```bash
hermes --tui
```

В интерфейсе можно отправлять запросы агенту, просматривать ответы и отслеживать выполнение инструментов.

Полезные команды:

| **Команда** | **Действие** |
| --- | --- |
| `/help` | Открыть список команд |
| `/model` | Выбрать модель |
| `/sessions` | Переключиться между открытыми сессиями или создать новую |
| `/usage` | Посмотреть расход токенов и заполнение контекста |
| `/new` | Начать новый диалог |
| `/details` | Включить или скрыть подробности вызовов инструментов |

Чтобы продолжить последнюю сессию после выхода, запустите:

```bash
hermes --tui --continue
```

Чтобы открыть конкретную сохраненную сессию по идентификатору или названию, используйте:

```bash
hermes --tui --resume "<идентификатор_или_название>"
```

Основные сочетания клавиш:

| **Сочетание** | **Действие** |
| --- | --- |
| `Enter` | Отправить сообщение |
| `Alt+Enter` или `Ctrl+J` | Добавить новую строку |
| `Ctrl+C` | Прервать текущую операцию; повторное нажатие завершает Hermes |
| `Ctrl+D` | Выйти из Hermes |

После настройки отправьте агенту произвольный запрос и убедитесь, что он отвечает. Если используется AI Gateway, перед проверкой выберите модель командой `/model`.

Другие команды и возможности интерфейса описаны в [официальной документации Hermes](https://hermes-agent.nousresearch.com/docs/user-guide/tui).