Як додати 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, Meshy CLI використовує його замість цього.

Чи можу я встановити лише навичку 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. Аналіз придатності до друку безкоштовний.

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

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

Огляд

Meshy пропонує дві навички для Hermes Agent:

meshy-3d-generation: Текст у 3D, Зображення у 3D і Мульти-зображення у 3D, текстурування та ретекстурування за допомогою ШІ, ремеш під заданий бюджет полігонів, розгортання UV, авторигінг та анімація для гуманоїдних персонажів, а також експорт у GLB, FBX, OBJ, STL або USDZ.
meshy-3d-printing: аналіз і виправлення придатності до друку, одноколірний і багатоколірний 3MF, масштабування до реальних розмірів, продукти Creative Lab, такі як фігурки, лампи, брелоки та магніти на холодильник, а також передача даних у встановлений слайсер.

Кожна навичка встановлюється окремо, тож ви можете додати лише навичку друку, якщо вам потрібна тільки вона. Обидві навички запускають Meshy CLI — це пакет meshy-cli з npm. Ви входите один раз у браузері, і API-ключ не потрібен.

Навички з відкритим кодом доступні в репозиторії meshy-3d-agent на GitHub.

Перш ніж почати

Вам потрібен 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

Hermes перевіряє 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 не використовує навички в розмові, яка була відкрита під час їх встановлення, почніть нову сесію.

Коли ви вперше запросите модель, Hermes запускає процес входу Meshy CLI й надсилає вам посилання та одноразовий код.

Щоб увійти, виконайте такі кроки:

Відкрийте посилання на будь-якому пристрої.
Якщо сторінка запитує код, введіть код у поле Device code точно так, як показує Hermes, а потім натисніть Continue.
Якщо Meshy запропонує увійти, увійдіть у свій обліковий запис Meshy.
На сторінці Connect Meshy CLI натисніть Connect. Сторінка покаже Meshy CLI authorized.
Поверніться в чат. Hermes продовжить виконання вашого запиту.

Код дійсний 10 хвилин. Якщо він прострочений, попросіть Hermes видати новий. Ви можете підтвердити вхід у будь-якому браузері, тож це також працює, коли Hermes запущено на сервері або через SSH.

Meshy CLI зберігає сесію у файлі ~/.config/meshy/credentials.json. Кожен агент, який працює від імені того самого користувача на цьому комп'ютері, використовує спільну сесію. Якщо встановлено MESHY_API_KEY, CLI використовує цей API-ключ замість сесії браузера.

Приклади запитів

Опишіть завдання своїми словами. Наприклад:

Створи 3D-модель цуценяти хаскі та збережи її як GLB у ./assets.
Перетвори це фото на текстуровану 3D-модель і збережи пропорції. (прикріпіть зображення)
Створи три низькополігональні пляшки зілля для моєї гри, кожна менше 1500 трикутників.
Задай ригінг для цього гуманоїдного персонажа, додай анімацію ходьби та експортуй у FBX.
Допоможи мені надрукувати на 3D-принтері маленьку фігурку дракона, 80 мм заввишки, у форматі багатоколірного 3MF.

Наступні запити використовують попередній результат, наприклад зроби LOD на 1500 граней, тепер у форматі FBX або масштабуй до 150 мм. Щоб самостійно підтверджувати кожен платний крок, додайте до запиту запитай мене перед витратою кредитів.

Усунення несправностей

У наведеній нижче таблиці перелічено типові проблеми, їхні причини та способи усунення.

Проблема	Причина	Вирішення
Hermes не використовує навички Meshy	Hermes не завантажив навички у відкритій розмові або не зіставив ваш запит із ними.	Почніть нову сесію або згадайте Meshy у своєму запиті.
`node` або `npm` не знайдено	Node.js не встановлено, або Hermes не може його знайти.	Встановіть Node.js версії 22.12 або новішої з вебсайту Node.js, а потім перезапустіть Hermes.
Hermes запитує API-ключ	Навичкам він не потрібен. Вони входять через ваш браузер.	Відмовтесь і попросіть Hermes увійти через браузер замість цього. Ніколи не вставляйте API-ключ у чат.
Код входу прострочено	Код дійсний 10 хвилин.	Попросіть Hermes знову почати процес входу.
Hermes не може виконати генерацію через ваш план або кредити	Для генерації потрібен платний план і достатня кількість кредитів.	Перевірте свій план і баланс на сторінці Subscription у веб-застосунку Meshy.
Ви увійшли не в той обліковий запис Meshy	Meshy CLI повторно використовує сесію, збережену на вашому комп'ютері.	Попросіть Hermes виконати `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, Meshy CLI використовує його замість цього.
Чи можу я встановити лише навичку 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. Аналіз придатності до друку безкоштовний.

Щоб використовувати ті самі навички в Codex, див. Плагін Meshy для Codex.
Щоб використовувати ті самі навички в OpenClaw, див. Навичка Meshy для OpenClaw.
Щоб викликати Meshy API з AI-агента за допомогою власного API-ключа, див. Інтеграція зі ШІ.