Skills Meshy pour Hermes Agent

Ajoutez les skills Meshy à Hermes Agent pour que votre agent puisse générer des modèles 3D, des textures et des animations, et préparer des impressions 3D, depuis un chat.

Vue d'ensemble

Meshy propose deux skills pour Hermes Agent :

  • meshy-3d-generation : Texte en 3D, Image en 3D et Multi-image en 3D, texturation et retexturation par IA, remesh vers un budget de polygones, dépliage UV, rigging automatique et animation pour les personnages humanoïdes, et export en GLB, FBX, OBJ, STL ou USDZ.
  • meshy-3d-printing : analyse et réparation de l'imprimabilité, 3MF monochrome et multicolore, mise à l'échelle vers des dimensions réelles, produits Creative Lab tels que figurines, lampes, porte-clés et magnets de frigo, et transfert vers un trancheur installé.

Chaque skill s'installe indépendamment, vous pouvez donc n'ajouter que le skill d'impression si c'est tout ce dont vous avez besoin. Les deux skills exécutent le CLI Meshy, qui est le package meshy-cli sur npm. Vous vous connectez une seule fois dans votre navigateur, et vous n'avez pas besoin de clé API.

Les skills sont open source dans le dépôt meshy-3d-agent sur GitHub.

Avant de commencer

  • Vous avez besoin de Hermes Agent.

  • Vous avez besoin de Node.js 22.12 ou ultérieur, avec npm, sur l'ordinateur qui exécute Hermes.

  • Pour générer des modèles, vous avez besoin d'un plan Meshy payant. Chaque tâche de génération consomme des crédits Meshy aux tarifs de l'API. Pour connaître le coût de chaque tâche, consultez Tarification. L'analyse d'imprimabilité est gratuite, et les étapes d'impression locales, comme redimensionner un modèle ou l'ouvrir dans un trancheur, ne nécessitent pas de connexion.

Installer les skills

Pour laisser Hermes effectuer l'installation, collez le texte suivant dans 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

Hermes vérifie Node.js, installe le CLI Meshy ainsi que les deux skills, puis vous guide tout au long de la connexion.

Pour installer les skills vous-même, ajoutez-les depuis GitHub avec 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

Vous pouvez aussi installer les deux skills avec l'installeur skills :

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

Vous n'avez pas besoin d'un npm install -g meshy-cli global. Sans cela, les skills exécutent le CLI via npm exec. Une installation globale ne fait qu'accélérer le démarrage.

Si Hermes n'utilise pas les skills dans une conversation qui était ouverte pendant leur installation, démarrez une nouvelle session.

Se connecter

La première fois que vous demandez un modèle, Hermes lance la connexion au CLI Meshy et vous envoie un lien ainsi qu'un code à usage unique.

Pour vous connecter, suivez ces étapes :

  1. Ouvrez le lien sur n'importe quel appareil.

  2. Si la page demande un code, saisissez-le dans Device code exactement comme Hermes vous l'indique, puis cliquez sur Continue.

  3. Si Meshy vous demande de vous connecter, connectez-vous à votre compte Meshy.

  4. Sur la page Connect Meshy CLI, cliquez sur Connect. La page affiche Meshy CLI authorized.

    Page Connect Meshy CLI avec le compte connecté, les accès accordés au CLI, et les boutons Cancel et Connect

  5. Retournez dans le chat. Hermes poursuit la demande que vous avez faite.

Le code expire après 10 minutes. S'il expire, demandez-en un nouveau à Hermes. Vous pouvez approuver la connexion depuis n'importe quel navigateur, ce qui fonctionne donc aussi lorsque Hermes s'exécute sur un serveur ou via SSH.

Le CLI Meshy stocke la session dans ~/.config/meshy/credentials.json. Chaque agent exécuté sous le même utilisateur sur cet ordinateur partage la session. Si MESHY_API_KEY est défini, le CLI utilise cette clé API à la place de la session du navigateur.

Exemples de prompts

Décrivez la tâche avec vos propres mots. Par exemple :

  • Fais un modèle 3D d'un bébé husky et enregistre-le en GLB dans ./assets.
  • Transforme cette photo en modèle 3D texturé en conservant ses proportions. (joignez l'image)
  • Crée trois flacons de potion low-poly pour mon jeu, chacun avec moins de 1 500 triangles.
  • Rig ce personnage humanoïde, ajoute une animation de marche, et exporte-le en FBX.
  • Aide-moi à imprimer en 3D une petite figurine de dragon, 80 mm de haut, en 3MF multicolore.

Les demandes de suivi réutilisent le résultat précédent, par exemple crée un LOD à 1 500 faces, maintenant en FBX, ou mets-le à l'échelle de 150 mm. Pour approuver vous-même chaque étape payante, ajoutez demande-moi avant de dépenser des crédits à votre requête.

Dépannage

Le tableau suivant répertorie les problèmes courants, leurs causes et comment les résoudre.

ProblèmeCauseSolution
Hermes n'utilise pas les skills MeshyHermes n'a pas chargé les skills dans la conversation ouverte, ou n'a pas pu faire correspondre votre demande à ceux-ci.Démarrez une nouvelle session, ou mentionnez Meshy dans votre demande.
node ou npm est introuvableNode.js n'est pas installé, ou Hermes ne le trouve pas.Installez Node.js 22.12 ou ultérieur depuis le site de Node.js, puis redémarrez Hermes.
Hermes demande une clé APILes skills n'en ont pas besoin. Elles se connectent via votre navigateur.Refusez, et demandez à Hermes de se connecter via le navigateur à la place. Ne collez jamais de clé API dans un chat.
Le code de connexion a expiréUn code est valide pendant 10 minutes.Demandez à Hermes de relancer la connexion.
Hermes ne peut pas générer en raison de votre plan ou de vos créditsLa génération nécessite un plan payant et suffisamment de crédits.Vérifiez votre plan et votre solde sur la page Subscription de l'application web Meshy.
Vous êtes connecté au mauvais compte MeshyLe CLI Meshy réutilise la session qu'il a stockée sur votre ordinateur.Demandez à Hermes d'exécuter meshy auth logout, puis reconnectez-vous.

FAQ

Comment ajouter Meshy à Hermes Agent ?
Demandez à Hermes de suivre https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, ou exécutez hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation et la même commande pour meshy-3d-printing. Vous avez aussi besoin de Node.js 22.12 ou ultérieur avec npm.
Ai-je besoin d'une clé API Meshy ?
Non. Les skills se connectent via votre navigateur avec un code à usage unique, et le CLI Meshy stocke la session. Si MESHY_API_KEY est déjà défini dans votre environnement, le CLI Meshy l'utilise à la place.
Puis-je installer uniquement le skill d'impression 3D ?
Oui. meshy-3d-printing s'installe et fonctionne de manière autonome, y compris les étapes de génération dont une impression a besoin.
Fonctionne-t-il lorsque Hermes s'exécute sur un serveur distant ?
Oui. La connexion affiche un lien et un code que vous pouvez approuver depuis n'importe quel navigateur.
S'agit-il des mêmes skills que le plugin Codex ?
Oui. Le plugin Codex, Claude Code, Cursor et Hermes Agent utilisent tous meshy-3d-generation et meshy-3d-printing provenant du dépôt open source meshy-3d-agent.
Est-ce gratuit ?
Les skills sont gratuites et open source. Générer des modèles 3D nécessite un plan Meshy payant et consomme des crédits Meshy aux tarifs de l'API. L'analyse d'imprimabilité est gratuite.

Prochaines étapes