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

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

// Шаг 1

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

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

[Hermes Agent на GitHub](https://github.com/NousResearch/hermes-agent)

```
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 сама проверит установку и скажет, что сломано.»

[Документация: все способы установки](https://hermes-agent.nousresearch.com/docs/getting-started/installation)

---

// Шаг 2

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

```
hermes setup
```

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

- 1 «Самый быстрый вариант - Nous Portal» — Вход через браузер, ключ не нужен. На чистой установке запусти hermes setup --portal - заодно включится Tool Gateway с поиском в интернете.
- 2 «Своя облачная модель - OpenRouter» — Положи ключ OPENROUTER_API_KEY в ~/.hermes/.env или войди через браузер: hermes auth add openrouter --type oauth.
- 3 «Локальная модель - 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.»

[Все провайдеры моделей](https://hermes-agent.nousresearch.com/docs/integrations/providers)

---

// Шаг 3

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

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

```
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.»

[Документация: Телеграм](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram)

---

// Что он умеет

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

- 01 «Поиск в интернете» — С Nous Portal поиск уже включён через Tool Gateway. Иначе положи в ~/.hermes/.env один ключ на выбор: EXA_API_KEY, TAVILY_API_KEY, FIRECRAWL_API_KEY, PARALLEL_API_KEY или PERPLEXITY_API_KEY. Включить и проверить инструменты - hermes tools.
- 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 - запись должна там быть.»

[Документация: задачи по расписанию](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron)

[Документация: память](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory)

---

// Голос

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

Голосовые в Телеграме агент расшифровывает сам - локально через 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 - говоришь, агент сам ловит паузу и отвечает.»

[Документация: голосовой режим](https://hermes-agent.nousresearch.com/docs/user-guide/features/voice-mode)

---

// Финал

## Проверь себя

- [ ] Поставил 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 и поговорил с ним голосом

---

Источник: https://localhost:3000/m/hermes-agent-svoy-dzharvis-v-telegrame-za-10-minut
