Meshy skills voor Hermes Agent

Voeg de Meshy skills toe aan Hermes Agent, zodat je agent 3D-modellen, textures en animaties kan genereren en 3D-prints kan voorbereiden, vanuit een chat.


Overzicht

Meshy heeft twee skills voor Hermes Agent:

  • meshy-3d-generation: Tekst naar 3D, Afbeelding naar 3D en Multi-afbeelding naar 3D, AI-texturing en retexturing, remeshen naar een polygoonbudget, UV-unwrapping, automatische rigging en animatie voor humanoïde personages, en exporteren naar GLB, FBX, OBJ, STL of USDZ.
  • meshy-3d-printing: printbaarheidsanalyse en -reparatie, eenkleurige en meerkleurige 3MF, aanpassen aan werkelijke afmetingen, Creative Lab-producten zoals beeldjes, lampen, sleutelhangers en koelkastmagneten, en overdracht naar een geïnstalleerde slicer.

Elke skill installeert op zichzelf, dus je kunt alleen de printskill toevoegen als dat alles is wat je nodig hebt. Beide skills draaien de Meshy CLI, dat is het meshy-cli-pakket op npm. Je logt één keer in via je browser en je hebt geen API-sleutel nodig.

De skills zijn open source in de meshy-3d-agent-repository op GitHub.


Voordat je begint

  • Je hebt Hermes Agent nodig.

  • Je hebt Node.js 22.12 of hoger nodig, met npm, op de computer waarop Hermes draait.

  • Om modellen te genereren heb je een betaald Meshy-abonnement nodig. Elke generatietaak kost Meshy-credits tegen API-tarieven. Zie Prijzen voor de kosten van elke taak. Printbaarheidsanalyse is gratis, en lokale printstappen, zoals het herschalen van een model of het openen ervan in een slicer, vereisen geen inlog.


De skills installeren

Om Hermes de installatie te laten uitvoeren, plak je de volgende tekst in een 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 controleert Node.js, installeert de Meshy CLI en beide skills, en begeleidt je vervolgens door het inlogproces.

Om de skills zelf te installeren, voeg je ze toe vanaf GitHub met 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

Je kunt beide skills ook installeren met de skills-installer:

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

Je hebt geen globale npm install -g meshy-cli nodig. Zonder deze draaien de skills de CLI via npm exec. Een globale installatie zorgt alleen voor een snellere opstart.

Als Hermes de skills niet gebruikt in een gesprek dat open stond tijdens de installatie, start dan een nieuwe sessie.


Inloggen

De eerste keer dat je om een model vraagt, start Hermes de Meshy CLI-inlog en stuurt je een link en een eenmalige code.

Volg deze stappen om in te loggen:

  1. Open de link op elk apparaat.

  2. Als de pagina om een code vraagt, voer je de code in bij Device code precies zoals Hermes die toont, en klik je vervolgens op Continue.

  3. Als Meshy je vraagt om in te loggen, log dan in op je Meshy-account.

  4. Klik op de pagina Connect Meshy CLI op Connect. De pagina toont Meshy CLI authorized.

    Pagina Connect Meshy CLI met het ingelogde account, de toegang die de CLI krijgt, en de knoppen Cancel en Connect

  5. Ga terug naar de chat. Hermes gaat verder met het verzoek dat je hebt gedaan.

De code verloopt na 10 minuten. Als deze verloopt, vraag je Hermes om een nieuwe. Je kunt de inlog vanaf elke browser goedkeuren, dus het werkt ook wanneer Hermes op een server of via SSH draait.

De Meshy CLI slaat de sessie op in ~/.config/meshy/credentials.json. Elke agent die als dezelfde gebruiker op die computer draait, deelt de sessie. Als MESHY_API_KEY is ingesteld, gebruikt de CLI die API-sleutel in plaats van de browsersessie.


Voorbeeldprompts

Beschrijf de taak in je eigen woorden. Bijvoorbeeld:

  • Maak een 3D-model van een husky-pup en sla het op als GLB in ./assets.
  • Verander deze foto in een getextureerd 3D-model en behoud de verhoudingen. (voeg de afbeelding toe)
  • Maak drie low-poly drankflesjes voor mijn game, elk onder de 1.500 driehoeken.
  • Rig dit humanoïde personage, voeg een loopanimatie toe en exporteer het als FBX.
  • Help me een klein drakenbeeldje in 3D te printen, 80 mm hoog, als meerkleurige 3MF.

Vervolgverzoeken hergebruiken het vorige resultaat, bijvoorbeeld maak een LOD met 1.500 vlakken, nu als FBX, of schaal het naar 150 mm. Om elke betaalde stap zelf goed te keuren, voeg je vraag me voordat je credits uitgeeft toe aan je verzoek.


Probleemoplossing

De volgende tabel geeft een overzicht van veelvoorkomende problemen, hun oorzaken en de oplossingen.

ProbleemOorzaakOplossing
Hermes gebruikt de Meshy skills nietHermes heeft de skills niet geladen in het open gesprek, of heeft je verzoek er niet aan gekoppeld.Start een nieuwe sessie, of vermeld Meshy in je verzoek.
node of npm wordt niet gevondenNode.js is niet geïnstalleerd, of Hermes kan het niet vinden.Installeer Node.js 22.12 of hoger vanaf de Node.js-website, en start Hermes daarna opnieuw.
Hermes vraagt om een API-sleutelDe skills hebben er geen nodig. Ze loggen in via je browser.Weiger, en vraag Hermes om in plaats daarvan via de browser in te loggen. Plak nooit een API-sleutel in een chat.
De inlogcode is verlopenEen code is 10 minuten geldig.Vraag Hermes om de inlog opnieuw te starten.
Hermes kan niet genereren vanwege je abonnement of creditsGenereren vereist een betaald abonnement en voldoende credits.Controleer je abonnement en saldo op de pagina Subscription in de Meshy web-app.
Je bent ingelogd op het verkeerde Meshy-accountDe Meshy CLI hergebruikt de sessie die op je computer is opgeslagen.Vraag Hermes om meshy auth logout uit te voeren en log daarna opnieuw in.

FAQ

Hoe voeg ik Meshy toe aan Hermes Agent?
Vraag Hermes om https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md te volgen, of voer hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation uit en hetzelfde commando voor meshy-3d-printing. Je hebt ook Node.js 22.12 of hoger met npm nodig.
Heb ik een Meshy API-sleutel nodig?
Nee. De skills loggen in via je browser met een eenmalige code, en de Meshy CLI slaat de sessie op. Als MESHY_API_KEY al is ingesteld in je omgeving, gebruikt de Meshy CLI die in plaats daarvan.
Kan ik alleen de 3D-printskill installeren?
Ja. meshy-3d-printing installeert en werkt op zichzelf, inclusief de generatiestappen die een print nodig heeft.
Werkt het wanneer Hermes op een externe server draait?
Ja. De inlog toont een link en een code die je vanaf elke browser kunt goedkeuren.
Zijn dit dezelfde skills als de Codex-plug-in?
Ja. De Codex-plug-in, Claude Code, Cursor en Hermes Agent gebruiken allemaal meshy-3d-generation en meshy-3d-printing uit de opensource meshy-3d-agent-repository.
Is het gratis?
De skills zijn gratis en open source. Het genereren van 3D-modellen vereist een betaald Meshy-abonnement en kost Meshy-credits tegen API-tarieven. Printbaarheidsanalyse is gratis.