Habilidades de Meshy para Hermes Agent

Las habilidades oficiales de Meshy para Hermes Agent permiten que tu agente genere modelos 3D, texturas y animaciones, y prepare impresiones 3D, todo desde un chat.


Resumen

Meshy ya está disponible para Hermes Agent, con dos habilidades:

  • meshy-3d-generation: texto a 3D, imagen a 3D y multivista a 3D, texturizado y retexturizado con IA, remesh hasta un presupuesto de polígonos, desenvolvimiento UV, auto-rigging y animación para personajes humanoides, y exportación a GLB, FBX, OBJ, STL o USDZ.
  • meshy-3d-printing: análisis y reparación de imprimibilidad, 3MF de un solo color y multicolor, ajuste de tamaño a dimensiones reales, productos de Creative Lab (figuras, lámparas, llaveros, imanes de nevera) y entrega a un laminador instalado.

Cada habilidad se instala por separado, así que puedes añadir solo la de impresión si es lo único que necesitas. Ambas utilizan la Meshy CLI. Inicias sesión una vez en tu navegador; no se necesita clave de API.


Requisitos

  • Hermes Agent.
  • Node.js 22.12 o más reciente, con npm, en la máquina donde se ejecuta Hermes.
  • Un plan de Meshy de pago para la generación. Cada tarea de generación consume créditos de Meshy según las tarifas de la API. El análisis de imprimibilidad es gratuito, y los pasos locales de impresión, como reescalar un modelo o abrirlo en un laminador, no requieren iniciar sesión.

Instalación

La forma más rápida es dejar que Hermes se encargue de la configuración. Pega esto en un chat:

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

El agente verifica Node.js, instala la Meshy CLI y ambas habilidades, y te guía durante el inicio de sesión.

Para instalarlo manualmente, añade las habilidades desde GitHub con 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

O instala ambas con el instalador de skills:

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

Una instalación global con npm install -g meshy-cli es opcional; sin ella, las habilidades ejecutan la CLI mediante npm exec. Inicia una nueva sesión de Hermes después de instalar para que las habilidades se carguen.


Iniciar sesión

La primera vez que pidas un modelo, el agente ejecutará el inicio de sesión por dispositivo de la Meshy CLI y te enviará un enlace y un código de un solo uso:

  1. Abre el enlace en cualquier dispositivo e inicia sesión en Meshy.
  2. Introduce el código exactamente como se muestra y luego haz clic en Connect.
  3. El agente continúa con la solicitud que hiciste.

Página de conexión de Meshy CLI

El código caduca a los 10 minutos; pídele al agente uno nuevo si eso ocurre. El flujo por dispositivo funciona desde cualquier navegador, así que también funciona cuando Hermes se ejecuta en un servidor o por SSH. La Meshy CLI almacena la sesión en ~/.config/meshy/credentials.json y la comparte con todos los agentes bajo la misma cuenta de usuario. Si MESHY_API_KEY está configurada, tendrá prioridad sobre la sesión del navegador.


Ejemplos de instrucciones

  • Crea un modelo 3D de un cachorro de husky y guárdalo como GLB en ./assets.
  • Convierte esta foto en un modelo 3D con textura y conserva sus proporciones. (adjunta la imagen)
  • Crea tres botellas de poción low-poly para mi juego, cada una con menos de 1500 triángulos.
  • Aplica rigging a este personaje humanoide, añade una animación de caminar y expórtalo como FBX.
  • Ayúdame a imprimir en 3D una pequeña figura de dragón, de 80 mm de alto, como 3MF multicolor.

Las instrucciones de seguimiento reutilizan el resultado anterior: crea un LOD de 1500 caras, ahora como FBX, escálalo a 150 mm. Añade pídeme permiso antes de gastar créditos para aprobar cada paso de pago.


Solución de problemas

SíntomaSolución
Hermes no usa las habilidades de MeshyInicia una nueva sesión después de instalar, o menciona Meshy en tu solicitud.
node o npm no se encuentraInstala Node.js 22.12 o más reciente desde nodejs.org, luego reinicia Hermes.
El agente pide una clave de APIRecházalo y pídele que inicie sesión a través del navegador en su lugar. Nunca pegues una clave de API en un chat.
El código de inicio de sesión caducóPídele al agente que vuelva a iniciar el proceso de inicio de sesión. Los códigos son válidos durante 10 minutos.
La generación se rechaza por plan o créditosLa generación requiere un plan de pago y créditos suficientes. Revisa tu plan y saldo en meshy.ai.
Se inició sesión en la cuenta de Meshy equivocadaPídele al agente que ejecute meshy auth logout, y luego inicia sesión de nuevo.

FAQ

¿Cómo añado Meshy a Hermes Agent?
Pídele a Hermes que siga https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, o ejecuta hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation y lo mismo para meshy-3d-printing. También necesitas Node.js 22.12 o más reciente con npm.
¿Necesito una clave de API de Meshy?
No. Las habilidades inician sesión a través de tu navegador con un código de un solo uso, y la Meshy CLI almacena la sesión. Si MESHY_API_KEY ya está configurada en tu entorno, tendrá prioridad.
¿Puedo instalar solo la habilidad de impresión 3D?
Sí. meshy-3d-printing se instala y funciona de forma independiente, incluyendo los pasos de generación que una impresión necesita.
¿Funciona cuando Hermes se ejecuta en un servidor remoto?
Sí. El inicio de sesión por dispositivo muestra un enlace y un código que puedes aprobar desde cualquier navegador.
¿Son las mismas habilidades que el complemento de Codex?
Sí. El complemento de Codex, Claude Code, Cursor y Hermes Agent utilizan todos meshy-3d-generation y meshy-3d-printing del repositorio de código abierto meshy-3d-agent.
¿Es gratis?
Las habilidades son gratuitas y de código abierto. Generar modelos 3D requiere un plan de Meshy de pago y consume créditos de Meshy según las tarifas de la API. El análisis de imprimibilidad es gratuito.