Что такое Profile Builder и зачем он нужен?
Profile Builder – это конфигурационный генератор для Hermes Agent, позволяющий быстро собрать нужный набор параметров без ручного правки YAML‑файлов. По сути, это небольшая веб‑формочка, где выбираете провайдера, включаете‑выключаете инструменты и задаете серверы MCP. Всё это «вываливается» в готовый файл ~/.hermes/profiles/researcher/config.yaml, который потом подхватывается агентом.
Ключевые боли, которые решает Profile Builder
- Сложность настройки. Без Builder вам придётся писать YAML “в лоб”, угадывая имена параметров и их типы.
- Ошибки в синтаксисе. Одна лишняя табуляция — и агент откажется стартовать.
- Переключение между провайдерами. Нужно сменить OpenRouter на NVIDIA? В Builder это просто выпадающий список.
- Управление инструментами. Включение/выключение наборов инструментов теперь делается одной галочкой, а не правкой
agent.disabled_toolsets. - Добавление MCP‑серверов. Не надо копировать‑вставлять блоки кода, Builder собирает карту
mcp_serversавтоматически.
Как пользоваться формой шаг за шагом
1. Выбор провайдера. В выпадающем меню Provider выбираете нужный сервис: OpenRouter, Nous Portal, NVIDIA или свой кастомный OpenAI‑compatible endpoint. После выбора Builder подставит соответствующий URL и токен в конфигурацию.
2. Управление набором инструментов. Если хотите отключить встроенные инструменты, переключайте опцию «Off». В итоговом файле это будет записано в agent.disabled_toolsets.
3. Добавление MCP‑серверов. Выбираете тип сервера (Filesystem, GitHub, HTTP), указываете путь или URL и нажимаете +. Builder добавит запись в карту mcp_servers с выбранным именем сервера в качестве ключа.
4. Получение готового YAML. В правой части окна появляется путь к файлу (~/.hermes/profiles/researcher/config.yaml) и кнопка Copy. Нажмите её — конфигурация скопируется в буфер, и вы можете вставить её в свой профиль или сохранить прямо в указанном месте.
Практические рекомендации
- Тестируйте каждый провайдер отдельно. После генерации конфигурации запустите
hermes-agent --check-config, чтобы убедиться, что все поля корректны. - Не храните токены в открытом виде. После создания YAML переместите значения
api_keyв защищённый.env‑файл и укажите в конфиге переменную окружения. - Организуйте MCP‑серверы по смыслу. Например,
fs:/data/projectsдля локального кеша,github:myorg/repoдля репозитория моделей иhttp:https://api.example.comдля внешних сервисов. - Версионируйте конфиги. Добавьте
config.yamlв Git, но исключите секцию с секретами через.gitignore.
Скачать и посмотреть исходники
Исходный код Builder находится в репозитории GitHub – hermes-agent/profile-builder. Там же можно найти инструкция по локальному запуску демо‑версии.
Где искать ответы, если что‑то пошло не так
- Официальная документация Hermes Agent: github.com/hermes-agent/hermes.
- Раздел «Issues» в репозитории Builder – часто задаваемые вопросы и решения.
- Комьюнити‑чат в Discord (ссылка в README репозитория).





















