Tutorial 12: Nix & NixOS Setup

Урок 12: Настройка Nix и NixOS

С возвращением в нашу серию уроков по Hermes Agent! В этом посте мы разберем установку Hermes Agent на системах Nix и NixOS. Но вот в чем дело — официальная документация изменилась, и Nix больше не является явно поддерживаемым способом установки. Но не переживайте! У вас всё еще есть варианты, и мы расскажем обо всем, что вам нужно знать.

Что изменилось?

Команда Hermes значительно упростила установку. Вместо поддержки нескольких способов установки они теперь рекомендуют универсальный установщик для всех — включая пользователей Nix. Поддержка Nix теперь осуществляется «по мере возможности», то есть она может работать, но официально не тестируется и не гарантируется.

Рекомендуемый путь: универсальный установщик

Для большинства пользователей самый простой способ запустить Hermes Agent — это установщик в одну команду. Он работает на Linux, macOS, WSL2 и даже на Android (Termux):

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

На нативной Windows используйте PowerShell:

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

Установщик автоматически обрабатывает всё: Python, Node.js, ripgrep, ffmpeg, клонирование репозитория, виртуальное окружение и глобальную команду hermes. По завершении вы готовы к общению.

А как насчет специальной настройки для Nix?

Если вы уже используете Nix (на NixOS, macOS или Linux), всё еще существует специальный путь настройки с Nix flake, декларативным модулем NixOS и опциональным контейнерным режимом. Ознакомьтесь с руководством Nix & NixOS Setup в официальной документации для подробностей.

Но наш совет: сначала попробуйте универсальный установщик. Это официально поддерживаемый путь, и он создан, чтобы «просто работать».

Предварительные требования: всё просто

Перед запуском установщика убедитесь, что у вас есть:

• Git (обязателен на всех платформах, кроме Windows)
• curl и xz-utils на Linux (установщик загружает Node.js в виде архива .tar.xz)
• g++ или build-essential на Debian/Ubuntu (только если вы планируете использовать десктопное приложение)

Вот и всё! Вам не нужно вручную устанавливать Python, Node.js, ripgrep или ffmpeg. Установщик сам определит, чего не хватает, и установит это за вас.

На Debian/Ubuntu вы можете подготовить всё одной командой:

sudo apt install curl xz-utils build-essential

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

Когда установщик завершит работу, перезагрузите вашу оболочку и начинайте общение:

source ~/.bashrc   # или: source ~/.zshrc
hermes             # Начать общение!

Настройка вашей конфигурации

После установки вы можете тонко настроить параметры с помощью специальных команд:

hermes model          # Выбор провайдера LLM и модели
hermes tools          # Настройка доступных инструментов
hermes gateway setup  # Настройка мессенджер-платформ
hermes config set     # Установка отдельных значений конфигурации
hermes config get     # Просмотр отдельных значений конфигурации
hermes setup          # Или запустите полный мастер настройки

Самый быстрый путь: Nous Portal

Вот профессиональный совет: если вы хотите избежать возни с ключами для каждого инструмента, используйте Nous Portal. Одна подписка покрывает более 300 моделей плюс Tool Gateway (веб-поиск, генерация изображений, TTS, облачный браузер). Начните работу одной командой:

hermes setup --portal

Это войдет в систему, установит Nous в качестве провайдера и включит Tool Gateway — всё сразу.

Переезд с другого устройства?

Если вы уже запускаете Hermes на другой машине, вам не нужно собирать всё с нуля. Восстановите полную резервную копию с помощью hermes import или перенесите отдельного агента с помощью hermes profile import. Просто помните: экспорт профиля по умолчанию исключает учетные данные, так что это не полная резервная копия. Для этого используйте hermes backup.

Заключение

Хотя Nix больше не является официально поддерживаемым способом установки, универсальный установщик делает настройку проще, чем когда-либо. Для большинства пользователей это оптимальный путь — даже на NixOS. Если возникнут проблемы, специальное руководство по Nix всё еще доступно в качестве запасного варианта.

В следующем уроке нашей серии мы углубимся в настройку вашего первого агента. А пока — приятного общения!