Meshy Skills para Hermes Agent

As skills oficiais do Meshy para o Hermes Agent permitem que 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 agora 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 de UV, auto-rigging e animação para personagens humanoides, e exportação para GLB, FBX, OBJ, STL ou USDZ.
  • meshy-3d-printing: análise e reparo de imprimibilidade, 3MF de cor única e multicolorido, dimensionamento para medidas reais, produtos do Creative Lab (bonecos, luminárias, chaveiros, ímãs de geladeira) e transferência para um fatiador instalado.

Cada skill é instalada separadamente, então você pode adicionar apenas a de impressão caso seja só isso que precise. Ambas utilizam o Meshy CLI. Você entra uma vez no seu navegador; nenhuma chave de API é necessária.

Requisitos

  • Hermes Agent.
  • Node.js 22.12 ou mais recente, com npm, na máquina onde o Hermes roda.
  • Um plano pago do Meshy para geração. Toda tarefa de geração gasta créditos do Meshy de acordo com as taxas da API. A análise de imprimibilidade é gratuita, e as etapas locais de impressão, como redimensionar um modelo ou abri-lo em um fatiador, não exigem login.

Instalação

A forma mais rápida é deixar o Hermes fazer a configuração. Cole isto em um 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 te guia pelo processo de login.

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 por meio do npm exec. Inicie uma nova sessão do Hermes após a instalação para que as skills sejam carregadas.

Entrar

Na primeira vez que você solicitar um modelo, o agente executa o login por dispositivo do Meshy CLI e te envia um link e um código de uso único:

  1. Abra o link em qualquer dispositivo e faça login no Meshy.
  2. Digite o código exatamente como mostrado e clique em Connect.
  3. O agente prossegue com a solicitação que você fez.

Página de conexã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 em qualquer navegador, então isso também funciona quando o Hermes roda em um servidor ou via SSH. O Meshy CLI armazena a sessão em ~/.config/meshy/credentials.json e a compartilha com todos os agentes sob a mesma conta de usuário. Se MESHY_API_KEY estiver definido, ele tem prioridade sobre a sessão do navegador.

Exemplos de Prompts

  • Faça um modelo 3D de um filhote de husky e salve-o como GLB em ./assets.
  • Transforme esta foto em um modelo 3D texturizado e mantenha suas proporções. (anexe a imagem)
  • Crie três garrafas de poção low-poly para meu jogo, cada uma com menos de 1.500 triângulos.
  • Faça o rig deste personagem humanoide, adicione uma animação de caminhada e exporte-o como FBX.
  • Ajude-me a imprimir em 3D um pequeno boneco de dragão, de 80 mm de altura, como um 3MF multicolorido.

Solicitações de acompanhamento reutilizam o resultado anterior: faça um LOD de 1.500 faces, agora como FBX, redimensione para 150 mm. Adicione pergunte antes de gastar créditos para aprovar cada etapa paga.

Solução de problemas

SintomaSolução
O Hermes não usa as skills do MeshyInicie uma nova sessão após a instalação, ou mencione o Meshy na sua solicitação.
node ou npm não encontradoInstale o Node.js 22.12 ou mais recente em nodejs.org, depois reinicie o Hermes.
O agente pede uma chave de APIRecuse e peça que ele faça login pelo navegador. Nunca cole uma chave de API em um chat.
O código de login expirouPeça ao agente para iniciar o login novamente. Os códigos são válidos por 10 minutos.
A geração é recusada por plano ou créditosA geração exige um plano pago e créditos suficientes. Confira seu plano e saldo em meshy.ai.
Login feito na conta errada do MeshyPeça ao agente para executar meshy auth logout, depois faça login novamente.

FAQ

Como adiciono o Meshy ao Hermes Agent?
Peça ao Hermes para seguir https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, ou execute hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation e o mesmo para meshy-3d-printing. Você também precisa do Node.js 22.12 ou mais recente com npm.
Preciso de uma chave de API do Meshy?
Não. As skills fazem login pelo seu navegador com um código de uso único, e o Meshy CLI armazena a sessão. Se MESHY_API_KEY já estiver definida no seu ambiente, ela tem prioridade.
Posso instalar apenas a skill de impressão 3D?
Sim. meshy-3d-printing instala e funciona de forma independente, incluindo as etapas de geração que uma impressão precisa.
Funciona quando o Hermes roda em um servidor remoto?
Sim. O login por dispositivo mostra um link e um código que você pode aprovar a partir de qualquer navegador.
Essas são as mesmas skills do plugin do Codex?
Sim. O plugin do Codex, o Claude Code, o Cursor e o Hermes Agent usam todos meshy-3d-generation e meshy-3d-printing do repositório de código aberto meshy-3d-agent.
É gratuito?
As skills são gratuitas e de código aberto. Gerar modelos 3D exige um plano pago do Meshy e gasta créditos do Meshy de acordo com as taxas da API. A análise de imprimibilidade é gratuita.

Links Relacionados