Навыки Meshy для Hermes Agent

Официальные навыки Meshy для Hermes Agent позволяют вашему агенту создавать 3D-модели, текстуры и анимации, а также готовить модели к 3D-печати — и всё это прямо из чата.

Обзор

Meshy теперь доступен для Hermes Agent в виде двух навыков:

  • meshy-3d-generation: текст в 3D, изображение в 3D и мультивид в 3D, AI-текстурирование и ретекстурирование, remesh с учётом бюджета полигонов, развёртка UV, автоматический rigging и анимация для гуманоидных персонажей, а также экспорт в GLB, FBX, OBJ, STL или USDZ.
  • meshy-3d-printing: анализ и устранение проблем с пригодностью к печати, одно- и многоцветный 3MF, подгонка под реальные размеры, продукты Creative Lab (фигурки, лампы, брелоки, магниты на холодильник) и передача данных в установленный слайсер.

Каждый навык устанавливается отдельно, поэтому можно добавить только печать, если больше ничего не нужно. Оба навыка работают через Meshy CLI. Вы входите в систему один раз через браузер; API-ключ не требуется.

Требования

  • Hermes Agent.
  • Node.js 22.12 или новее с npm на машине, на которой работает Hermes.
  • Платный план Meshy для генерации. Каждая задача генерации расходует кредиты Meshy по тарифам API. Анализ пригодности к печати бесплатен, а локальные этапы печати, такие как изменение масштаба модели или открытие её в слайсере, не требуют входа в систему.

Установка

Самый быстрый способ — позволить Hermes выполнить настройку. Вставьте это в чат:

Help me install Meshy CLI and the meshy-3d-agent skills:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Агент проверит Node.js, установит Meshy CLI и оба навыка, а также проведёт вас через процесс входа.

Чтобы установить вручную, добавьте навыки из GitHub с помощью Hermes:

hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing

Либо установите оба с помощью инсталлятора skills:

npx -y skills add meshy-dev/meshy-3d-agent --skill meshy-3d-generation --skill meshy-3d-printing -g -y -a hermes-agent

Глобальная установка npm install -g meshy-cli не обязательна; без неё навыки запускают CLI через npm exec. После установки начните новую сессию Hermes, чтобы навыки загрузились.

Вход

При первом запросе модели агент запускает вход через устройство в Meshy CLI и отправляет вам ссылку и одноразовый код:

  1. Откройте ссылку на любом устройстве и войдите в Meshy.
  2. Введите код точно так, как он показан, затем нажмите Connect.
  3. Агент продолжит выполнение вашего запроса.

Страница подключения Meshy CLI

Срок действия кода истекает через 10 минут; если это произошло, попросите агента выдать новый. Вход через устройство работает в любом браузере, поэтому это также подходит для случаев, когда Hermes работает на сервере или через SSH. Meshy CLI сохраняет сессию в ~/.config/meshy/credentials.json и использует её для всех агентов под одной учётной записью пользователя. Если задана переменная MESHY_API_KEY, она имеет приоритет над сессией браузера.

Примеры запросов

  • Сделай 3D-модель щенка хаски и сохрани её как GLB в ./assets.
  • Преврати это фото в текстурированную 3D-модель и сохрани пропорции. (прикрепите изображение)
  • Создай три низкополигональных бутылочки с зельем для моей игры, каждая менее 1500 треугольников.
  • Сделай rig для этого гуманоидного персонажа, добавь анимацию ходьбы и экспортируй в FBX.
  • Помоги напечатать на 3D-принтере маленькую фигурку дракона высотой 80 мм в виде многоцветного 3MF.

Последующие запросы используют предыдущий результат: сделай LOD на 1500 граней, теперь в FBX, масштабируй до 150 мм. Добавьте спрашивай меня перед тратой кредитов, чтобы подтверждать каждый платный этап.

Устранение неполадок

СимптомРешение
Hermes не использует навыки MeshyНачните новую сессию после установки или упомяните Meshy в своём запросе.
node или npm не найденыУстановите Node.js 22.12 или новее с nodejs.org, затем перезапустите Hermes.
Агент запрашивает API-ключОткажитесь и попросите его выполнить вход через браузер. Никогда не вставляйте API-ключ в чат.
Срок действия кода входа истёкПопросите агента заново начать вход. Код действителен 10 минут.
Генерация отклоняется из-за плана или кредитовДля генерации нужен платный план и достаточно кредитов. Проверьте свой план и баланс на meshy.ai.
Выполнен вход не в ту учётную запись MeshyПопросите агента выполнить meshy auth logout, затем войдите снова.

FAQ

Как добавить Meshy в Hermes Agent?
Попросите Hermes перейти по ссылке https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, либо выполните hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation и аналогично для meshy-3d-printing. Также потребуется Node.js 22.12 или новее с npm.
Нужен ли мне API-ключ Meshy?
Нет. Навыки выполняют вход через браузер с помощью одноразового кода, а Meshy CLI сохраняет сессию. Если в вашем окружении уже задана переменная MESHY_API_KEY, она имеет приоритет.
Можно ли установить только навык 3D-печати?
Да. meshy-3d-printing устанавливается и работает самостоятельно, включая этапы генерации, необходимые для печати.
Работает ли это, когда Hermes запущен на удалённом сервере?
Да. Вход через устройство показывает ссылку и код, которые можно подтвердить из любого браузера.
Это те же навыки, что и в плагине Codex?
Да. Плагин Codex, Claude Code, Cursor и Hermes Agent — все используют meshy-3d-generation и meshy-3d-printing из открытого репозитория meshy-3d-agent.
Это бесплатно?
Навыки бесплатны и имеют открытый исходный код. Для генерации 3D-моделей требуется платный план Meshy, и она расходует кредиты Meshy по тарифам API. Анализ пригодности к печати бесплатен.

Похожие ссылки