Ho bisogno di una chiave API Meshy?

No. Le skill accedono tramite il tuo browser con un codice monouso, e la Meshy CLI memorizza la sessione. Se MESHY_API_KEY è già impostata nel tuo ambiente, la Meshy CLI la usa al suo posto.

Posso installare solo la skill di stampa 3D?

Sì. meshy-3d-printing si installa e funziona autonomamente, inclusi i passaggi di generazione di cui una stampa ha bisogno.

Funziona quando Hermes viene eseguito su un server remoto?

Sì. L'accesso mostra un link e un codice che puoi approvare da qualsiasi browser.

Sono le stesse skill del plugin Codex?

Sì. Il plugin Codex, Claude Code, Cursor e Hermes Agent utilizzano tutti meshy-3d-generation e meshy-3d-printing dal repository open source meshy-3d-agent.

Le skill sono gratuite e open source. Generare modelli 3D richiede un piano Meshy a pagamento e consuma crediti Meshy alle tariffe API. L'analisi della stampabilità è gratuita.

Skill Meshy per Hermes Agent

Aggiungi le skill Meshy a Hermes Agent in modo che il tuo agente possa generare modelli 3D, texture e animazioni, e preparare stampe 3D, direttamente da una chat.

Panoramica

Meshy offre due skill per Hermes Agent:

meshy-3d-generation: Testo in 3D, Immagine in 3D e Multi-immagine in 3D, texturing e ritexturing con AI, remesh verso un budget di poligoni, UV unwrapping, rigging automatico e animazione per personaggi umanoidi, ed esportazione in GLB, FBX, OBJ, STL o USDZ.
meshy-3d-printing: analisi e riparazione della stampabilità, 3MF monocolore e multicolore, dimensionamento in base a misure reali del mondo fisico, prodotti Creative Lab come statuette, lampade, portachiavi e magneti da frigo, e trasferimento a uno slicer installato.

Ogni skill si installa autonomamente, quindi puoi aggiungere solo la skill di stampa se è l'unica di cui hai bisogno. Entrambe le skill eseguono la Meshy CLI, che è il pacchetto meshy-cli su npm. Accedi una sola volta nel browser e non hai bisogno di una chiave API.

Le skill sono open source nel repository meshy-3d-agent su GitHub.

Prima di iniziare

Ti serve Hermes Agent.
Ti serve Node.js 22.12 o versione successiva, con npm, sul computer su cui gira Hermes.
Per generare modelli, ti serve un piano Meshy a pagamento. Ogni attività di generazione consuma crediti Meshy alle tariffe API. Per il costo di ciascuna attività, consulta Prezzi. L'analisi della stampabilità è gratuita, e i passaggi di stampa locali, come il ridimensionamento di un modello o la sua apertura in uno slicer, non richiedono l'accesso.

Installa le skill

Per far eseguire la configurazione a Hermes, incolla il seguente testo in una 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 verifica Node.js, installa la Meshy CLI ed entrambe le skill, e poi ti guida nell'accesso.

Per installare tu stesso le skill, aggiungile da 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

Puoi anche installare entrambe le skill con l'installer skills:

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

Non hai bisogno di un npm install -g meshy-cli globale. Senza di esso, le skill eseguono la CLI tramite npm exec. Un'installazione globale rende solo l'avvio più veloce.

Se Hermes non usa le skill in una conversazione che era aperta mentre le installavi, avvia una nuova sessione.

La prima volta che richiedi un modello, Hermes avvia l'accesso alla Meshy CLI e ti invia un link e un codice monouso.

Per accedere, segui questi passaggi:

Apri il link su un qualsiasi dispositivo.
Se la pagina richiede un codice, inserisci il codice in Device code esattamente come mostrato da Hermes, e poi fai clic su Continue.
Se Meshy ti chiede di accedere, accedi al tuo account Meshy.
Nella pagina Connect Meshy CLI, fai clic su Connect. La pagina mostra Meshy CLI authorized.
Torna alla chat. Hermes continua la richiesta che hai fatto.

Il codice scade dopo 10 minuti. Se scade, chiedi a Hermes di generarne uno nuovo. Puoi approvare l'accesso da qualsiasi browser, quindi funziona anche quando Hermes viene eseguito su un server o tramite SSH.

La Meshy CLI memorizza la sessione in ~/.config/meshy/credentials.json. Ogni agente eseguito come lo stesso utente su quel computer condivide la sessione. Se MESHY_API_KEY è impostata, la CLI usa quella chiave API al posto della sessione del browser.

Esempi di prompt

Descrivi il lavoro con parole tue. Ad esempio:

Crea un modello 3D di un cucciolo di husky e salvalo come GLB in ./assets.
Trasforma questa foto in un modello 3D texturizzato e mantieni le sue proporzioni. (allega l'immagine)
Crea tre bottiglie di pozione low-poly per il mio gioco, ciascuna sotto i 1.500 triangoli.
Fai il rigging di questo personaggio umanoide, aggiungi un'animazione di camminata ed esportalo come FBX.
Aiutami a stampare in 3D una piccola statuetta di drago, alta 80 mm, come 3MF multicolore.

Le richieste di follow-up riutilizzano il risultato precedente, ad esempio crea un LOD da 1.500 facce, ora come FBX, oppure scalalo a 150 mm. Per approvare tu stesso ogni passaggio a pagamento, aggiungi chiedimi prima di spendere crediti alla tua richiesta.

Risoluzione dei problemi

La tabella seguente elenca i problemi comuni, le loro cause e come risolverli.

Problema	Causa	Soluzione
Hermes non usa le skill Meshy	Hermes non ha caricato le skill nella conversazione aperta, oppure non ha associato la tua richiesta a esse.	Avvia una nuova sessione, oppure menziona Meshy nella tua richiesta.
`node` o `npm` non viene trovato	Node.js non è installato, oppure Hermes non riesce a trovarlo.	Installa Node.js 22.12 o versione successiva dal sito web di Node.js, e poi riavvia Hermes.
Hermes chiede una chiave API	Le skill non ne hanno bisogno. Accedono tramite il tuo browser.	Rifiuta, e chiedi a Hermes di accedere invece tramite il browser. Non incollare mai una chiave API in una chat.
Il codice di accesso è scaduto	Un codice è valido per 10 minuti.	Chiedi a Hermes di avviare di nuovo l'accesso.
Hermes non riesce a generare a causa del tuo piano o dei crediti	La generazione richiede un piano a pagamento e crediti sufficienti.	Controlla il tuo piano e il saldo nella pagina Subscription nell'app web Meshy.
Hai effettuato l'accesso con l'account Meshy sbagliato	La Meshy CLI riutilizza la sessione memorizzata sul tuo computer.	Chiedi a Hermes di eseguire `meshy auth logout`, e poi accedi di nuovo.

FAQ

Come aggiungo Meshy a Hermes Agent?: Chiedi a Hermes di seguire https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, oppure esegui hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation e lo stesso comando per meshy-3d-printing. Ti serve anche Node.js 22.12 o versione successiva con npm.
Ho bisogno di una chiave API Meshy?: No. Le skill accedono tramite il tuo browser con un codice monouso, e la Meshy CLI memorizza la sessione. Se MESHY_API_KEY è già impostata nel tuo ambiente, la Meshy CLI la usa al suo posto.
Posso installare solo la skill di stampa 3D?: Sì. meshy-3d-printing si installa e funziona autonomamente, inclusi i passaggi di generazione di cui una stampa ha bisogno.
Funziona quando Hermes viene eseguito su un server remoto?: Sì. L'accesso mostra un link e un codice che puoi approvare da qualsiasi browser.
Sono le stesse skill del plugin Codex?: Sì. Il plugin Codex, Claude Code, Cursor e Hermes Agent utilizzano tutti meshy-3d-generation e meshy-3d-printing dal repository open source meshy-3d-agent.
È gratuito?: Le skill sono gratuite e open source. Generare modelli 3D richiede un piano Meshy a pagamento e consuma crediti Meshy alle tariffe API. L'analisi della stampabilità è gratuita.

Per usare le stesse skill in Codex, consulta Plugin Meshy per Codex.
Per usare le stesse skill in OpenClaw, consulta Skill Meshy per OpenClaw.
Per chiamare la Meshy API da un agente AI con la tua chiave API, consulta Integrazione AI.