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

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

Огляд

Meshy тепер доступний для Hermes Agent у вигляді двох навичок:

  • meshy-3d-generation: текст у 3D, зображення у 3D та мультивид у 3D, AI-текстурування та ретекстурування, ремеш до заданого бюджету полігонів, розгортання UV, автоматичний ріггінг і анімація для гуманоїдних персонажів, а також експорт у 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 трикутників.
  • Зроби ріг для цього гуманоїдного персонажа, додай анімацію ходьби та експортуй у 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

How do I add Meshy to Hermes Agent?
Ask Hermes to follow https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, or run hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation and the same for meshy-3d-printing. You also need Node.js 22.12 or newer with npm.
Do I need a Meshy API key?
No. The skills sign in through your browser with a one-time code, and the Meshy CLI stores the session. If MESHY_API_KEY is already set in your environment, it takes priority.
Can I install only the 3D printing skill?
Yes. meshy-3d-printing installs and works on its own, including the generation steps a print needs.
Does it work when Hermes runs on a remote server?
Yes. The device sign-in shows a link and a code that you can approve from any browser.
Are these the same skills as the Codex plugin?
Yes. The Codex plugin, Claude Code, Cursor and Hermes Agent all use meshy-3d-generation and meshy-3d-printing from the open-source meshy-3d-agent repository.
Is it free?
The skills are free and open source. Generating 3D models requires a paid Meshy plan and spends Meshy credits at API rates. Printability analysis is free.

Пов'язані посилання