Установка Opencode и Hermes

1.

МАСТЕР-КЛАСС
ИИ-агенты:
установка и настройка с
нуля
WSL · Ubuntu · OpenCode + Superpowers
Hermes Agent · Handy · Obsidian
Михаил Малышев (@tsingular) · 12 июня 2026

2.

ВВЕДЕНИЕ
Зачем нужны кодовые ИИ-агенты
ИИ-агент — это не чат-бот. Он сам выполняет команды в терминале, читает и пишет файлы, ищет в
интернете и доводит задачу до результата. Вы ставите цель — агент делает работу.
Разработка кода
Документы и отчёты
Пишет, правит и отлаживает код, делает
рефакторинг, настраивает проекты и окружение
— даже если вы не программист.
Создаёт и редактирует тексты, презентации,
таблицы; превращает черновики и заметки в
готовые материалы.
Исследования
Автоматизация рутины
Собирает информацию из веба и файлов,
сравнивает источники, готовит обзоры и
аналитические сводки.
Разбирает файлы и почту, конвертирует
форматы, чинит настройки системы, выполняет
повторяющиеся задачи.

3.

ПЛАН
Маршрут мастер-класса
1
2
WSL
5
Подсистема Linux в Windows
Универсальный агент: CLI в WSL
Ubuntu
Hermes Desktop + Handy
6
Установка, пользователь, перезагрузка
3
Node.js + обновление
LTS внутри Ubuntu, apt update / upgrade
4
Hermes Agent
OpenCode + Superpowers
Кодовый агент с бесплатной моделью и навыками
Версия для Windows и голосовой ввод
7
Obsidian
Заметки и память для Hermes

4.

ШАГ 1 · ПОДГОТОВКА
Что такое WSL и зачем он нужен
WSL (Windows Subsystem for Linux) — полноценный Linux
внутри Windows, без виртуальных машин и второй системы.
Почти все ИИ-агенты «родом» из Linux — в WSL они
работают стабильнее всего,- навыки и конфиги ложатся в
нужные папки, а некоторых модулей в чистой среде
Windows вообще нет или они требуют сложной установки.
opencode: WSL даёт более высокую производительность
файловой системы и полноценный терминал.
Hermes: WSL2 — это настоящее Linux-ядро; Hermes в нём
работает как на обычной Ubuntu.
Источник: opencode.ai/docs/ru/windows-wsl · hermes-agent.nousresearch.com/docs/user-guide/windows-wsl-quickstart

5.

ШАГ 1 · ПОДГОТОВКА
Устанавливаем WSL
Откройте PowerShell от имени администратора (Пуск →
введите «PowerShell» → правой кнопкой → «Запуск от имени
администратора») и выполните одну команду:
$ wsl --install
Команда сама включит нужные компоненты Windows, поставит
ядро WSL2 и дистрибутив Ubuntu по умолчанию.
Вы так же можете сначала посмотреть доступные
дистрибутивы и установить конкретный:
$ wsl --list –online
$ wsl --install –d Ubuntu
Требуется Windows 10 (22H2+) или Windows 11.
Источник: Официальное руководство Microsoft: learn.microsoft.com/windows/wsl/install

6.

ШАГ 2 · UBUNTU
Устанавливаем Ubuntu: два способа
Вариант А — Microsoft Store
Вариант Б — командная строка
Откройте Microsoft Store, найдите «Ubuntu» (берите
версию LTS не Pro) и нажмите «Получить».
Посмотреть доступные дистрибутивы и установить
Ubuntu из PowerShell:
$ wsl --list --online
$ wsl --install -d Ubuntu
Ubuntu LTS — то, на чём тестируется Hermes Agent.
Это самый предсказуемый выбор для новичка.
Источник: hermes-agent.nousresearch.com/docs/user-guide/windows-wsl-quickstart (раздел «Distro choice»)

7.

ШАГ 2 · UBUNTU
Перезагрузка и первый запуск — самое важное
1
2
Перезагрузите компьютер
Обязательно! Без перезагрузки компоненты WSL не
«подхватятся» и Ubuntu не запустится или запустится с
ошибками.
Ubuntu откроется сама
После входа в Windows откроется окно Ubuntu и завершит
установку. (если нет, - запускайте через меню)
3
Создайте пользователя и пароль
Это новый Linux-пользователь — он не связан с вашей
учёткой Windows. Пароль при вводе не отображается —
это нормально.
ЗАПОМНИТЕ ПАРОЛЬ!
Этот пароль понадобится дальше для всех команд sudo (установка и обновление программ). Запишите его
в надёжное место прямо сейчас.

8.

ШАГ 2 · UBUNTU
Проверяем, что работает именно WSL2
После перезагрузки откройте PowerShell и проверьте версию:
$ wsl --list --verbose
NAME
STATE
VERSION
* Ubuntu
Running 2
В колонке VERSION должна быть цифра 2. Если стоит 1 —
переключите:
$ wsl --set-version Ubuntu 2
$ wsl --set-default-version 2
Документация Hermes однозначно предупреждает: на WSL1 агент
работает ненадёжно — нужен именно WSL2.
Источник: hermes-agent.nousresearch.com/docs/user-guide/windows-wsl-quickstart (раздел «Install WSL2»)

9.

ШАГ 3 · ОКРУЖЕНИЕ
Ставим Node.js LTS внутри Ubuntu
Node.js нужен агентам для части инструментов.
Откройте nodejs.org/en/download, выберите LTS → Linux → nvm и скопируйте команды с сайта
(кнопка справа внизу).
Проверка после установки —
обе команды должны
напечатать версии:
$ node -v && npm –v
v24.16.0
10.9.7
Источник: nodejs.org/en/download — всегда копируйте актуальные команды с официального сайта

10.

ШАГ 3 · ОКРУЖЕНИЕ
Обновляем Ubuntu
Перед установкой агентов приведём систему в актуальное
состояние. В терминале Ubuntu:
$ sudo apt update
$ sudo apt upgrade -y
apt update — обновляет список доступных пакетов.
apt upgrade — устанавливает свежие версии.
Вот здесь и пригодится пароль из шага 2: sudo попросит его
ввести.
По ходу обновления будет контрольный вопрос нужно ли
скачивать пакеты – отвечайте Y

11.

ШАГ 4 · OPENCODE
OpenCode — кодовый агент в терминале
OpenCode — открытый ИИ-агент для работы в терминале.
Официальная русская документация рекомендует для Windows
именно WSL и даёт одну команду установки:
$ curl -fsSL https://opencode.ai/install \
| bash
После установки можно закрыть и открыть Ubuntu окно, чтобы
подтянулись пути. И дальше запуск — просто командой:
$ opencode
Совет из документации: держите проекты в файловой системе WSL
(например, ~/code/) — так работает быстрее.
Источник: opencode.ai/docs/ru/windows-wsl — раздел «Настройка»

12.

ШАГ 4 · OPENCODE
Выбираем бесплатную модель
Внутри opencode откройте список моделей командой
/models.
Выберите бесплатную модель — например, DeepSeek V4
Flash (модели с пометкой «free»).
Бесплатной модели достаточно для обучения, настройки
системы и повседневных задач.
Платные модели можно подключить позже — когда
поймёте, что вам нужно больше.
/models
→ DeepSeek V4 Flash (free)

13.

ШАГ 4 · OPENCODE
Superpowers: «суперсилы» для агента
Superpowers (автор — Jesse Vincent, github.com/obra/superpowers) — открытый набор «навыков» (skills)
и целая методология работы для кодовых агентов.
Сначала думает, потом
делает
Дисциплина и план
Не только про код
Агент не бросается писать код:
уточняет задачу вопросами,
согласует с вами дизайн и только
потом составляет план.
Работа разбивается на маленькие
проверяемые шаги;
агент может работать часами
автономно, не отклоняясь от плана.
Навыки помогут и нам: если что-то
в Ubuntu пойдёт не так —
OpenCode с Superpowers
бесплатно поможет разобраться и
починить конфигурацию.
Источник: github.com/obra/superpowers — README, разделы «How it works» и «The Basic Workflow»

14.

ШАГ 4 · OPENCODE
Устанавливаем Superpowers в OpenCode
Установка для OpenCode выполняется одной фразой — просто
скопируйте эту команду агенту в чате opencode:
Fetch and follow instructions from
https://raw.githubusercontent.com/obra/
superpowers/refs/heads/main/.opencode/
INSTALL.md
Агент сам скачает и выполнит инструкцию установки.
После установки выйдите из opencode (Ctrl+D) и зайдите снова
— навыки подхватятся.
Проверили, что всё работает? Снова Ctrl+D: opencode нам пока
больше не нужен.
Источник: github.com/obra/superpowers — раздел «Installation → OpenCode»

15.

ШАГ 5 · HERMES
Hermes Agent — универсальный ИИ-агент
Hermes Agent — открытый (MIT) агент от Nous Research.
Если OpenCode, - про код, то Hermes, это ваш личный ИИ помощник «на каждый день»:
Терминал и файлы
Веб и исследования
Выполняет команды, работает с файлами и
проектами на вашей машине.
Поиск в интернете, браузер, сбор информации,
подготовка сводок.
Мессенджеры
Навыки и память
Подключается к Telegram, Discord, Slack,
WhatsApp — агент всегда под рукой.
Skills-каталог, сессии, планировщик, голос — и
различные типы памяти.
Источник: github.com/nousresearch/hermes-agent · hermes-agent.nousresearch.com/docs

16.

ШАГ 5 · HERMES
Устанавливаем Hermes в WSL
Документация: для Linux / WSL2 — одна команда. Установщик
сам поставит все зависимости (Python, Node.js, ripgrep, ffmpeg)
— нужен только git:
$ curl -fsSL https://hermes-agent.
nousresearch.com/install.sh | bash
После установки перезагрузите оболочку и запустите:
$ source ~/.bashrc
$ hermes
Если увидите «hermes: command not found» — просто откройте
новый терминал или повторите source ~/.bashrc.
Источник: hermes-agent.nousresearch.com/docs/getting-started/installation и .../quickstart

17.

ШАГ 5 · HERMES
Первый запуск: провайдер, модель, проверка
Главный шаг настройки по Quickstart-документации — выбор
провайдера модели:
$ hermes model
$ hermes --tui
$ hermes -c
$ hermes doctor
# выбор провайдера
# современный интерфейс
# продолжить сессию
# диагностика проблем
Провайдеров десятки: от Nous Portal до OpenRouter, DeepSeek,
бесплатных OAuth-вариантов.
Правило из документации: пока не работает обычный чат — не
добавляйте новые функции.
Критерий успеха: агент отвечает, использует инструменты,
диалог продолжается.
Источник: hermes-agent.nousresearch.com/docs/getting-started/quickstart

18.

ШАГ 5 · HERMES-ПОДКЛЮЧАЕМ OPENROUTER
Openrouter – бесплатные модели
Один из провайдеров, где всегда есть бесплатные модели, Openrouter.
Создаём акканут.
Заходим на https://openrouter.ai/workspaces/default/keys
Создаём ключ API
Идём по ссылке https://openrouter.ai/models и ищем доступные
бесплатные модели.
Например находим: https://openrouter.ai/nousresearch/hermes-3llama-3.1-405b:free
Или https://openrouter.ai/google/gemma-4-31b-it:free (последняя
хороша мультимодальностью.
$ hermes model
# выбираем Openrouter, вставляем
ключ и выбираем модель Hermes

19.

ШАГ 6 · HERMES DESKTOP
Hermes Desktop для Windows — без WSL
У Hermes есть и десктоп-версия с установщиком для Windows и
macOS, - рекомендуется для обычных пользователей.
Сначала поставьте Node.js LTS под Windows: установщик с
nodejs.org (как на шаге 3, но версия для Windows).
Затем скачайте Hermes Desktop ТОЛЬКО по официальной
ссылке (ниже) и запустите установщик.
hermes-agent.nousresearch.com/desktop
ОСТОРОЖНО: ФИШИНГ!
По поисковому запросу «hermes desktop» сейчас много поддельных сайтов с вредоносными
установщиками. Никогда не качайте из поисковой выдачи и рекламы. Единственный официальный адрес
— hermes-agent.nousresearch.com/desktop. Проверяйте домен nousresearch.com в адресной строке!!!

20.

ШАГ 6 · ПОЛЕЗНЫЕ ФИШКИ
Handy — голосовой ввод в любом приложении
Handy (handy.computer) — бесплатное open source приложение
«речь → текст». Зажали горячую клавишу, сказали, отпустили —
текст вставился в активное поле ввода, а голос распознаётся
локально у вас на компьютере.
Работает в любом приложении: терминал с агентом,
мессенджер, браузер, документы.
Приватноcть: распознавание идёт локально, голос не
отправляется в облако.
Режимы push-to-talk и вкл/выкл, горячая клавиша
настраивается.
Диктовать агенту задачи голосом, - гораздо быстрее, чем
печатать.
Источник: handy.computer — загрузка: handy.computer/download

21.

ШАГ 7 · OBSIDIAN
Obsidian — заметки и память для агента
Obsidian — популярное приложение для заметок: всё хранится
локально в обычных Markdown-файлах в папке-«хранилище»
(vault).
Скачайте с официального сайта obsidian.md и установите под
Windows.
При первом запуске создайте vault — папку для заметок
(запомните, где она).
Для нас это сразу две роли: база заметок и документов +
долговременная память Hermes.
Markdown — «родной» формат для ИИ-агентов: они свободно
читают и пишут такие файлы.
Источник: obsidian.md — официальный сайт

22.

ШАГ 7 · OBSIDIAN
Подключаем Obsidian к Hermes
Самое приятное: настраивать вручную ничего не нужно.
Просто скажите Гермесу — он знает, как это сделать:
Вы → Hermes:
«Найди мой Obsidian vault и подключи его себе для
работы с заметками и памятью»
Hermes сам найдёт папку vault (в т.ч. на диске Windows через
/mnt/c/...) и настроит доступ.
Дальше агент может читать заметки, создавать документы и
вести свою память в вашем vault.
Результат: вы видите и редактируете «память» агента как
обычные заметки в Obsidian.

23.

ИТОГИ
Что у вас теперь есть
WSL2 + Ubuntu
Node.js LTS и свежая система
Полноценный Linux внутри Windows, пользователь и
пароль для sudo.
Окружение готово к любым инструментам.
OpenCode + Superpowers
Hermes Agent (CLI + Desktop)
Кодовый агент с бесплатной моделью и методологией
навыков.
Универсальный агент в терминале и на рабочем столе
Windows.
Handy
Obsidian + память Hermes
Голосовой ввод в любом приложении — локально и
бесплатно.
Заметки, документы и долговременная память агента в
одном vault.
Достаточно для начала. Дальше — практика: дайте агентам первую настоящую задачу!

24.

ИСТОЧНИКИ И ДОКУМЕНТАЦИЯ
Все ссылки — официальные
WSL (Microsoft)
Hermes — Windows (WSL2)
learn.microsoft.com/windows/wsl/install
hermes-agent.nousresearch.com/docs/user-guide/windows-wslquickstart
Node.js
Hermes Desktop (официальный!)
nodejs.org/en/download
hermes-agent.nousresearch.com/desktop
OpenCode — Windows (WSL), рус.
Hermes — GitHub
opencode.ai/docs/ru/windows-wsl
github.com/nousresearch/hermes-agent
Superpowers
Handy
github.com/obra/superpowers
handy.computer
Hermes — Quickstart
Obsidian
hermes-agent.nousresearch.com/docs/getting-started/quickstart
obsidian.md
Hermes — Installation
hermes-agent.nousresearch.com/docs/getting-started/installation