Развёртывание AI-агента Hermes в WSL
на базе DeepSeek API

Обзор

Hermes Agent — открытый автономный AI-агент от Nous Research, работающий в терминале. В отличие от «чат-обёрток», он умеет выполнять команды, читать и писать файлы, искать в интернете, ставить задачи по расписанию и запоминать контекст между сессиями.

В качестве «мозга» агента мы подключим DeepSeek API — китайский провайдер LLM с низкими ценами и OpenAI-совместимым API. Hermes поддерживает DeepSeek «из коробки».

В итоге у вас будет:

• Рабочее окружение Linux внутри Windows (WSL2).
• Установленный Hermes Agent с командой hermes в терминале.
• Настроенный провайдер DeepSeek и активный API-ключ.
• Проверенный первый запрос к агенту.

Предварительные требования

Откройте PowerShell от имени администратора (Пуск → введите «PowerShell» → правый клик → «Запуск от имени администратора») и выполните одну команду:

PS> wsl --install

Эта команда сама включит компонент WSL, виртуальную машину и установит дистрибутив Ubuntu по умолчанию. После выполнения перезагрузите компьютер.

После перезагрузки Ubuntu запустится автоматически и попросит придумать:

• имя пользователя Linux (латиницей, строчными, например amigo);
• пароль (при вводе символы не отображаются — это нормально).

Если WSL уже установлен — проверьте версию

PS> wsl --list --verbose
PS> wsl --set-default-version 2
PS> wsl --update

Столбец VERSION должен показывать 2. Если стоит 1 — выполните для нужного дистрибутива:

PS> wsl --set-version Ubuntu 2

Установка конкретного дистрибутива

# Список доступных дистрибутивов
PS> wsl --list --online

# Установить Debian вместо Ubuntu
PS> wsl --install -d Debian

Откройте терминал Linux (команда wsl в PowerShell, либо ярлык «Ubuntu» в меню Пуск). Дальше все команды выполняются внутри Linux.

2.1. Обновление пакетов

$ sudo apt update && sudo apt upgrade -y

2.2. Установка базовых зависимостей

Установщику Hermes нужны Git, curl, tar и утилиты контрольных сумм:

$ sudo apt install -y git curl tar ca-certificates unzip

2.3. Проверка установленного

$ git --version
$ curl --version
$ sha256sum --version

2.4. Общие рекомендации по WSL

• Файлы Linux держите в Linux. Обращение к /mnt/c/... работает, но медленнее. Домашняя папка Linux — это ~ (например /home/amigo).
• Автозапуск systemd. Чтобы шлюз Hermes работал как служба, добавьте в файл /etc/wsl.conf строку [boot] / systemd=true:

  $ sudo tee /etc/wsl.conf <<'EOF'
  [boot]
  systemd=true
  EOF

  Затем в PowerShell: wsl --shutdown и снова войдите в WSL.

DeepSeek предоставляет доступ к моделям по API. Чтобы получить ключ, нужно создать аккаунт на платформе разработчика и пополнить баланс — оплата идёт по факту израсходованных токенов.

3.1. Регистрация аккаунта

1. Откройте https://platform.deepseek.com в браузере.
2. Нажмите Sign up / Войти. Регистрация доступна по e-mail или через аккаунт Google.
3. Подтвердите e-mail (придёт письмо с кодом или ссылкой).
4. Войдите в личный кабинет.

3.2. Пополнение баланса

1. В личном кабинете выберите раздел Top up / Balance (Пополнение).
2. Внесите сумму, например $5–$10 — этого хватает на десятки миллионов токенов на моделях Flash (см. раздел «Цены» ниже).
3. Оплатите картой. Средства зачислятся на баланс почти сразу.

3.3. Создание API-ключа

1. Откройте раздел API Keys — прямая ссылка: https://platform.deepseek.com/api_keys.
2. Нажмите Create new API key.
3. Задайте понятное имя, например hermes-wsl (имя нужно только для вас).
4. Скопируйте появившийся ключ целиком — он начинается с sk- и выглядит примерно так:

   sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3.4. Рекуперация средств при утечке

• Удалите скомпрометированный ключ в разделе API Keys (кнопка Remove/Rotate).
• Создайте новый ключ и обновите его в конфигурации Hermes.
• При необходимости смените пароль аккаунта DeepSeek.

3.5. Реквизиты подключения (на будущее)

Эти значения понадобятся на шаге 5.

В терминале WSL выполните одну команду:

$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Что произойдёт:

• скрипт склонирует исходный код в ~/.hermes/hermes-agent/;
• скачает и развернёт собственные uv, Python, Node.js, ripgrep, FFmpeg;
• создаст лаунчер ~/.local/bin/hermes;
• подготовит каталог данных ~/.hermes/;
• по умолчанию установит инструменты браузера (agent-browser + Chromium) и драйвер computer-use.

Активация команды hermes

После установки перезагрузите конфигурацию оболочки:

$ source ~/.bashrc

Если команда всё ещё не найдена — добавьте каталог лаунчера в PATH:

$ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

Проверка установки

$ hermes --version
# Пример вывода:
# Hermes Agent v0.21.x ... · Install directory: ~/.hermes/hermes-agent
# Python: 3.14.x

Есть два пути: интерактивный мастер или ручная правка конфигурации. Можно использовать оба — начните с мастера, при необходимости уточните вручную.

Вариант A. Интерактивный мастер (рекомендуется)

$ hermes model

В открывшемся меню выберите:

1. Провайдера — DeepSeek.
2. Вставьте API-ключ sk-..., полученный на шаге 3 (при вводе он скрывается).
3. Модель по умолчанию — deepseek-flash (быстрая и дешёвая) или deepseek-v4-pro (умнее, дороже).

Полный мастер, включающий также настройку терминала, инструментов и шлюза:

$ hermes setup

Вариант B. Ручная настройка

Конфигурация хранится в ~/.hermes/config.yaml, а секреты — в ~/.hermes/.env. Откройте конфиг редактором:

$ hermes config edit

Убедитесь, что секции model и providers выглядят так:

model:
  provider: deepseek
  default: deepseek-flash
  base_url: https://api.deepseek.com
  api_key: sk-ВАШ_КЛЮЧ

providers:
  deepseek:
    type: openai
    base_url: https://api.deepseek.com
    api_key: sk-ВАШ_КЛЮЧ

Ключ через переменные окружения (альтернатива)

Можно не хранить ключ в YAML, а задать переменные в .env:

$ hermes config env-path
# выведет путь к .env, обычно ~/.hermes/.env

$ printf '\nDEEPSEEK_API_KEY=%s\nDEEPSEEK_BASE_URL=https://api.deepseek.com\n' \
    'sk-ВАШ_КЛЮЧ' >> ~/.hermes/.env

Отдельные значения можно выставлять без редактора:

$ hermes config set model.provider deepseek
$ hermes config set model.base_url https://api.deepseek.com
$ hermes config set model.default deepseek-flash

Смена модели «на лету»

Внутри сессии Hermes модель меняется слэш-командой:

> /model deepseek-v4-pro

6.1. Диагностика

$ hermes doctor

Команда проверит зависимости, конфигурацию и доступность провайдера, а при проблемах подскажет, что именно исправить. Полезно добавить флаг --fix для автоисправления типовых проблем.

6.2. Пробный запрос

$ hermes chat -q "Ответь одним предложением: какая сейчас дата?"

Если в ответ пришёл осмысленный текст — связка «Hermes → DeepSeek» работает.

6.3. Интерактивный режим

$ hermes

Вы попадёте в чат. Попробуйте реальную задачу, например:

> Покажи содержимое домашней папки и объясни, что там лежит
> Создай файл hello.py с простым скриптом и запусти его
> /help      # список всех слэш-команд
> /usage     # сколько токенов уже израсходовано
> /quit      # выход

6.4. Частые ошибки на этом шаге

Инструменты (Toolsets)

Интерактивное управление наборами инструментов — hermes tools. Самые нужные:

$ hermes tools list
$ hermes tools enable web
$ hermes tools disable image_gen

Память

$ hermes memory setup
$ hermes memory status

Агент сам запоминает предпочтения и факты об окружении, чтобы не переспрашивать.

Навыки (Skills)

$ hermes skills list
$ hermes skills search "excel"
$ hermes skills install <ID>

Задачи по расписанию (Cron)

$ hermes cron create "0 9 * * *"
$ hermes cron list

Мессенджеры (Gateway)

Чтобы общаться с агентом из Telegram, Discord или WhatsApp:

$ hermes gateway setup
$ hermes gateway install
$ hermes gateway status

Обновление и обслуживание

$ hermes update          # обновить Hermes до последней версии
$ hermes status          # состояние компонентов
$ hermes config check    # проверить конфиг на устаревшие опции

Ключевые пути

Цены DeepSeek — что ожидать

Оплата идёт за токены: отдельно за входящие (input) и исходящие (output). Цены указываются за 1 млн токенов. В непиковые часы действует скидка (примерно 50%).

Поскольку агент делает много вызовов инструментов за одну задачу, расход растёт быстрее, чем в обычном чате. Для экономии держите deepseek-flash моделью по умолчанию и переключайтесь на deepseek-v4-pro только когда нужна максимальная точность.

Устранение неполадок

Установка / WSL

DeepSeek API

Общие

• Изменения конфига не применяются: в CLI перезапустите hermes, в шлюзе — /restart.
• Инструменты не появились: сделайте /reset — новый старт сессии.
• Подробная диагностика: hermes doctor и логи ~/.hermes/logs/.
• Ключ в пуле исчерпан: hermes auth reset deepseek.

Безопасность

Хранение ключа

• Ключ храните только в ~/.hermes/.env или config.yaml. Оба файла должны иметь права 600:

$ chmod 600 ~/.hermes/.env ~/.hermes/config.yaml

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

Редактирование секретов в выводе

По умолчанию Hermes автоматически вырезает похожие на секреты строки (ключи, токены) из вывода инструментов, чтобы те не попали в контекст и логи:

$ hermes config set security.redact_secrets true    # включено по умолчанию

Подтверждение опасных команд

Перед выполнением разрушительных команд (например rm -rf) Hermes спрашивает подтверждение. Режимы: manual (по умолчанию), smart (авто-одобрение безопасных), off (пропускать всё):

$ hermes config set approvals.mode smart

Разовый пропуск подтверждений для конкретного запуска:

$ hermes --yolo chat -q "..."

Изоляция через профили

Для экспериментов и «опасных» задач заведите отдельный профиль с собственной конфигурацией, памятью и ключами — он не затронет основную установку:

$ hermes profile create sandbox
$ hermes --profile sandbox