Чек-лист
кодовое словоКарман

Hermes Agent: свой Джарвис в Телеграме за 10 минут

Ставишь бесплатный агент с открытым кодом Hermes Agent одной командой, выбираешь модель - хоть локальную - и подключаешь его к своему Телеграм-боту. Дальше он ищет в интернете, запускает задачи по расписанию, помнит прошлые разговоры и отвечает голосом.

Содержание6 глав
  1. 01Ставишь Hermes Agent одной командой
  2. 02hermes setup - выбираешь модель, хоть локальную
  3. 03hermes gateway setup - подключаешь Телеграм
  4. 04Поиск в интернете, задачи по расписанию и память
  5. 05Включаешь голос и просто разговариваешь
  6. 06Проверь себя

Шаг 1

Ставишь Hermes Agent одной командой

Hermes Agent - бесплатный агент с открытым кодом от Nous Research. Работает на Linux, macOS, WSL2 и в Windows. Открой терминал и вставь команду под свою систему.

Hermes Agent на GitHub

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

Linux, macOS, WSL2

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

Windows PowerShell

source ~/.zshrc    # или: source ~/.bashrc
hermes

Перечитай настройки оболочки и проверь, что агент запускается

Если что-то не так
Команда hermes doctor сама проверит установку и скажет, что сломано.

Документация: все способы установки


Шаг 2

hermes setup - выбираешь модель, хоть локальную

hermes setup

Мастер настройки - проводит по всему сразу

01
Самый быстрый вариант - Nous Portal
Вход через браузер, ключ не нужен. На чистой установке запусти hermes setup --portal - заодно включится Tool Gateway с поиском в интернете
02
Своя облачная модель - OpenRouter
Положи ключ OPENROUTER_API_KEY в ~/.hermes/.env или войди через браузер: hermes auth add openrouter --type oauth
03
Локальная модель - Ollama
Скачай модель и подними сервер с контекстом 64 000 токенов - меньше Hermes не потянет. Потом hermes model → Custom endpoint
ollama pull qwen2.5-coder:32b
OLLAMA_CONTEXT_LENGTH=64000 ollama serve

Локальная модель через Ollama

Base URL: http://localhost:11434/v1
API key: (оставь пустым)
Model name: qwen2.5-coder:32b

В hermes model выбери Custom endpoint и введи

Важно
У Ollama по умолчанию маленькое окно контекста - 4096 токенов. Без OLLAMA_CONTEXT_LENGTH=64000 агент будет тупить. Проверить окно - ollama ps. Модель потом меняется командой hermes model или прямо в чате: /model.

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


Шаг 3

hermes gateway setup - подключаешь Телеграм

01
Создай бота в @BotFather
Отправь /newbot, задай имя и юзернейм на bot, например my_hermes_bot. В ответ придёт токен вида 123456789:ABCdef… - никому его не показывай
02
Узнай свой числовой ID
Напиши @userinfobot - он пришлёт число. Нужно именно число, а не юзернейм
03
Запусти мастер и выбери Telegram
Мастер спросит токен и твой ID
04
Запусти шлюз и напиши боту
Бот оживает за пару секунд. Напиши ему «привет» - если ответил, Джарвис у тебя в кармане
hermes gateway setup
hermes gateway

Подключить Телеграм и запустить

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Или вручную - в файл ~/.hermes/.env

hermes gateway install

Чтобы бот работал всегда, а не пока открыт терминал

Безопасность
Всегда указывай TELEGRAM_ALLOWED_USERS - только с этих ID бот принимает команды. Токен утёк - отзови его в @BotFather командой /revoke.

Документация: Телеграм


Что он умеет

Поиск в интернете, задачи по расписанию и память

01
Поиск в интернете
С Nous Portal поиск уже включён через Tool Gateway. Иначе положи в ~/.hermes/.env один ключ на выбор: EXA_API_KEY, TAVILY_API_KEY, FIRECRAWL_API_KEY, PARALLEL_API_KEY или PERPLEXITY_API_KEY.
02
Задачи по расписанию
Просто попроси словами в Телеграме - агент сам заведёт задачу. Работает, пока запущен шлюз
03
Память
Агент сам ведёт заметки о тебе и о задачах в ~/.hermes/memories/ и ищет по прошлым разговорам. Важное попроси запомнить прямо, новое подхватится в следующей сессии - /new
Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

Задача по расписанию - просто напиши боту

/cron add "every 2h" "Check server status"
hermes cron create "every 2h" "Check server status"

Или командой в чате и из терминала

use the memory tool to save: я работаю с 10 до 19, отчёты присылай в 18:00

Гарантированно сохранить в память

Проверь память
Некоторые модели говорят «запомнил», но инструмент не вызывают. Загляни в ~/.hermes/memories/MEMORY.md и USER.md - запись должна там быть.

Документация: задачи по расписанию

Документация: память


Голос

Включаешь голос и просто разговариваешь

Голосовые в Телеграме агент расшифровывает сам - локально через faster-whisper, без ключа. Чтобы он отвечал голосом, отправь боту одну из команд.

/voice on      # голосом отвечает на твои голосовые
/voice tts     # голосом отвечает на всё
/voice off     # только текст
/voice status  # что сейчас включено

Команды в чате с ботом

brew install ffmpeg        # macOS
sudo apt install ffmpeg    # Ubuntu, Debian

Для голоса нужен ffmpeg

tts:
  provider: "edge"
  edge:
    voice: "ru-RU-DmitryNeural"

Голос по умолчанию - бесплатный edge, в ~/.hermes/config.yaml

В терминале
Запусти hermes, набери /voice on и жми Ctrl+B - говоришь, агент сам ловит паузу и отвечает.

Документация: голосовой режим


Финал

Проверь себя

  • Поставил Hermes Agent одной командой, и hermes запускается
  • Прошёл hermes setup и выбрал модель - Nous Portal, OpenRouter или локальную через Ollama
  • Для Ollama поднял сервер с OLLAMA_CONTEXT_LENGTH=64000
  • Создал бота в @BotFather и узнал свой ID в @userinfobot
  • Прошёл hermes gateway setup, указал TELEGRAM_ALLOWED_USERS
  • Запустил hermes gateway и получил ответ от бота в Телеграме
  • Поставил шлюз службой: hermes gateway install
  • Подключил поиск - Nous Portal или ключ в ~/.hermes/.env - и проверил в hermes tools
  • Завёл первую задачу по расписанию
  • Попросил агента запомнить факт о себе и нашёл его в ~/.hermes/memories/
  • Поставил ffmpeg, отправил боту /voice on и поговорил с ним голосом