Meshy Skills para o Hermes Agent

As skills oficiais do Meshy para o Hermes Agent permitem que o seu agente gere modelos 3D, texturas e animações e prepare impressões 3D, tudo a partir de um chat.

Visão geral

O Meshy já está disponível para o Hermes Agent, com duas skills:

  • meshy-3d-generation: texto para 3D, imagem para 3D e multivista para 3D, texturização e retexturização com IA, remesh para um orçamento de polígonos, desdobramento UV, rigging automático e animação para personagens humanoides, e exportação para GLB, FBX, OBJ, STL ou USDZ.
  • meshy-3d-printing: análise e reparação de imprimibilidade, 3MF monocromático e multicolor, ajuste de tamanho para dimensões reais, produtos do Creative Lab (figuras, candeeiros, porta-chaves, íman de frigorífico) e transferência para um software de corte instalado.

Cada skill instala-se de forma independente, pelo que pode adicionar apenas a de impressão se for isso que precisa. Ambas utilizam o Meshy CLI. Inicia sessão uma vez no seu navegador; não é necessária nenhuma chave de API.

Requisitos

  • Hermes Agent.
  • Node.js 22.12 ou mais recente, com npm, na máquina onde o Hermes é executado.
  • Um plano Meshy pago para geração. Cada tarefa de geração gasta créditos Meshy às taxas da API. A análise de imprimibilidade é gratuita, e os passos de impressão locais, como redimensionar um modelo ou abri-lo num software de corte, não requerem início de sessão.

Instalação

A forma mais rápida é deixar o Hermes fazer a configuração. Cole isto num chat:

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

O agente verifica o Node.js, instala o Meshy CLI e ambas as skills, e guia-o através do início de sessão.

Para instalar manualmente, adicione as skills a partir do GitHub com o 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

Ou instale ambas com o instalador skills:

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

Um npm install -g meshy-cli global é opcional; sem ele, as skills executam o CLI através do npm exec. Inicie uma nova sessão do Hermes após a instalação para que as skills sejam carregadas.

Iniciar sessão

Na primeira vez que pedir um modelo, o agente executa o início de sessão por dispositivo do Meshy CLI e envia-lhe um link e um código de uso único:

  1. Abra o link em qualquer dispositivo e inicie sessão no Meshy.
  2. Introduza o código exatamente como mostrado e, em seguida, clique em Connect.
  3. O agente dá continuidade ao pedido que fez.

Página de ligação do Meshy CLI

O código expira após 10 minutos; peça ao agente um novo código se isso acontecer. O fluxo por dispositivo funciona a partir de qualquer navegador, pelo que também funciona quando o Hermes é executado num servidor ou através de SSH. O Meshy CLI guarda a sessão em ~/.config/meshy/credentials.json e partilha-a com todos os agentes sob a mesma conta de utilizador. Se MESHY_API_KEY estiver definida, tem prioridade sobre a sessão do navegador.

Exemplos de pedidos

  • Faz um modelo 3D de um cachorro husky e guarda-o como GLB em ./assets.
  • Transforma esta foto num modelo 3D texturizado e mantém as suas proporções. (anexe a imagem)
  • Cria três frascos de poção low-poly para o meu jogo, cada um com menos de 1500 triângulos.
  • Faz o rig deste personagem humanoide, adiciona uma animação de caminhar e exporta-o como FBX.
  • Ajuda-me a imprimir em 3D uma pequena figura de dragão, com 80 mm de altura, como 3MF multicolor.

Os pedidos de continuação reutilizam o resultado anterior: faz um LOD de 1500 faces, agora como FBX, redimensiona para 150 mm. Adicione pergunta-me antes de gastar créditos para aprovar cada etapa paga.

Resolução de problemas

SintomaSolução
O Hermes não utiliza as skills do MeshyInicie uma nova sessão após a instalação, ou mencione o Meshy no seu pedido.
node ou npm não encontradoInstale o Node.js 22.12 ou mais recente a partir de nodejs.org e, em seguida, reinicie o Hermes.
O agente pede uma chave de APIRecuse e peça-lhe para iniciar sessão através do navegador. Nunca cole uma chave de API num chat.
O código de início de sessão expirouPeça ao agente para iniciar novamente o início de sessão. Os códigos são válidos durante 10 minutos.
A geração é recusada por motivos de plano ou créditosA geração requer um plano pago e créditos suficientes. Verifique o seu plano e saldo em meshy.ai.
Sessão iniciada na conta Meshy erradaPeça ao agente para executar meshy auth logout e, em seguida, inicie sessão novamente.

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.

Links relacionados