Руководство по установке

Запусти Hermes

Hermes Agent v0.8.0 устанавливается примерно за 60 секунд на Linux, macOS или WSL2. Одна команда curl, и установщик сам разберётся с uv, Python 3.11, Node.js, ripgrep и ffmpeg.

checklist Системные требования

javascript Node.js

Нужен только git — Python 3.11, Node.js v22, uv, ripgrep и ffmpeg устанавливаются скриптом

computer OS

Linux, macOS, WSL2 под Windows или Android через Termux. Нативная Windows не поддерживается.

memory RAM

Минимум 2 ГБ RAM; больше при запуске локальных моделей

hard_drive Disk

~1 ГБ для агента, его venv, Node-модулей и встроенных навыков

extension Optional

Опционально: Docker, SSH, Daytona, Singularity или Modal для изолированного выполнения команд

wifi Network

Интернет нужен для API облачных моделей. Локальные модели через OpenAI-совместимый эндпоинт работают офлайн.

Однострочник из официальной документации. Рекомендуется для большинства на Linux, macOS или WSL2. Документация по установке arrow_forward

WSL2 (Windows)

Нативная Windows не поддерживается. Запусти в WSL2-шелле после 'wsl --install'.

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

macOS / Linux / WSL2

Нужен только git — установщик сам поставит uv, Python 3.11, Node.js v22, ripgrep и ffmpeg.

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

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

Запусти команды проверки из официальной документации.

1
$ hermes version

Выведет установленную версию (должна быть 0.8.0 или новее).

2
$ hermes doctor

Запускает диагностику — Python, uv, зависимости, конфиг-файлы и подключение.

3
$ hermes status

Выводит текущую конфигурацию: провайдер модели, включённые инструменты и подключённые шлюзы.

settings Начальная настройка

После установки перезагрузи шелл, затем выполни три команды настройки из документации.

1

Выбери провайдера моделей

Запусти 'hermes model' для выбора провайдера. В README перечислены Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI и кастомные эндпоинты. Anthropic и Mistral также идут как зависимости.

2

Включи нужные инструменты

Запусти 'hermes tools' для настройки 47 встроенных инструментов. Можно добавить или убрать позже.

3

Запусти полный мастер настройки

Запусти 'hermes setup' для прохождения полного мастера, включая API-ключи и подключение чат-шлюзов (Telegram, Discord, Slack, WhatsApp, Signal, Email).

4

Отправь тестовое сообщение

Попробуй 'hermes chat -q "Привет! Какие инструменты у тебя есть?"' — прямо из официального quickstart.

.env — Конфиг хранится в ~/.hermes/ — config.yaml для основных настроек, .env для API-ключей, плюс подпапки для сессий, логов, памяти, навыков и cron-задач. Смотри справку по переменным окружения на hermes-agent.nousresearch.com/docs/reference/environment-variables.

cloud Деплой на VPS / сервер

Hermes работает на любом Linux VPS с 2 ГБ RAM и ~1 ГБ диска. Тот же однострочник работает по SSH.

1

Подключись к серверу по SSH

Любой Linux-дистрибутив подойдёт — Ubuntu, Debian, CentOS, Arch и т.д.

$ ssh user@your-server-ip
2

Запусти установщик

Скрипт определит твой дистрибутив, установит Python 3.11 через uv и настроит все зависимости.

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

Включи бэкенд-песочницу

На общей инфраструктуре настрой один из бэкендов-песочниц (Docker, SSH, Daytona, Singularity или Modal), чтобы shell-команды Hermes выполнялись в изоляции. Подробности в README.

4

Задай API-ключ и запусти

Выбери провайдера моделей и запусти Hermes. Используй tmux или screen для постоянства — процесс работает на переднем плане.

$ hermes model && hermes

Tip — Для постоянного демона запускай Hermes в tmux/screen или напиши systemd unit-файл. Подробности — в документации по daemon setup.

system_update_alt Обновление Hermes

В README задокументирован встроенный обновлятор: 'hermes update'. PyPI-пакета или Docker-образа нет, другие пути обновления — через git. Гайд по обновлению arrow_forward

npm
$ hermes update
pnpm
$ cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]"
Git
$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Docker
$ # Официальный Docker-образ пока не опубликован

Смотри github.com/NousResearch/hermes-agent/releases для списка изменений каждой версии.

delete_forever Удаление Hermes

Hermes устанавливается в ~/.hermes/hermes-agent/ и симлинкает бинарник в ~/.local/bin/hermes. Удалить оба — две команды. Заметки об удалении arrow_forward

npm
$ rm ~/.local/bin/hermes
pnpm
$ rm -rf ~/.hermes/hermes-agent
Git (Source)
$ rm -rf ~/.hermes/hermes-agent
Docker
$ # Нет официального Docker-образа для удаления

Удалить пользовательские данные (опционально)

Удалит сессии, память, навыки, cron-задачи и API-ключи. Сохрани всё нужное заранее.

macOS/Linux $ rm -rf ~/.hermes
Windows PS> # Запусти в WSL-шелле — нативная Windows не поддерживается

build Решение проблем

Из таблицы устранения неполадок в документации по установке и частых ошибок скрипта. Ещё советы по решению проблем arrow_forward

Нужна помощь?

Заходи в Discord Nous Research за поддержкой по установке и помощью от сообщества.

Будь в курсе

Новости сообщества о релизах Hermes Agent, новых навыках и интеграциях. Без спама, отписаться можно в любой момент.