Dovednosti Meshy pro Hermes Agent

Přidejte dovednosti Meshy do Hermes Agent, aby váš agent dokázal z chatu generovat 3D modely, textury a animace a připravovat 3D tisky.


Přehled

Meshy má pro Hermes Agent dvě dovednosti:

  • meshy-3d-generation: Text na 3D, Obrázek na 3D a Více obrázků na 3D, AI texturování a přetexturování, remeshing na zadaný rozpočet polygonů, UV rozbalení, automatický rigging a animace pro humanoidní postavy a export do GLB, FBX, OBJ, STL nebo USDZ.
  • meshy-3d-printing: analýza a oprava tisknutelnosti, jednobarevný i vícebarevný 3MF, přizpůsobení skutečným rozměrům, produkty Creative Lab, jako jsou figurky, lampy, přívěsky na klíče a magnetky na ledničku, a předání do nainstalovaného slicer.

Každá dovednost se instaluje samostatně, takže pokud potřebujete jen tisk, můžete přidat jen tuto dovednost. Obě dovednosti spouštějí Meshy CLI, což je balíček meshy-cli na npm. Přihlásíte se jednou ve svém prohlížeči a API klíč nepotřebujete.

Dovednosti jsou open source v repozitáři meshy-3d-agent na GitHubu.


Než začnete

  • Potřebujete Hermes Agent.

  • Na počítači, kde běží Hermes, potřebujete Node.js verze 22.12 nebo novější, s npm.

  • Pro generování modelů potřebujete placený plán Meshy. Každá generovací úloha spotřebovává kredity Meshy podle API sazeb. Náklady na jednotlivé úlohy najdete v sekci Ceny. Analýza tisknutelnosti je zdarma a lokální kroky tisku, jako je změna velikosti modelu nebo jeho otevření ve slicer, nevyžadují přihlášení.


Instalace dovedností

Aby nastavení provedl Hermes za vás, vložte do chatu následující text:

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

Hermes zkontroluje Node.js, nainstaluje Meshy CLI a obě dovednosti a poté vás provede přihlášením.

Pokud chcete dovednosti nainstalovat sami, přidejte je z GitHubu pomocí 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

Obě dovednosti můžete nainstalovat i pomocí instalátoru skills:

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

Globální instalaci npm install -g meshy-cli nepotřebujete. Bez ní dovednosti spouštějí CLI přes npm exec. Globální instalace jen zrychlí spuštění.

Pokud Hermes dovednosti nepoužije v konverzaci, která byla otevřená během instalace, spusťte novou relaci.


Přihlášení

Při první žádosti o model Hermes spustí přihlášení do Meshy CLI a pošle vám odkaz a jednorázový kód.

Při přihlašování postupujte takto:

  1. Otevřete odkaz na libovolném zařízení.

  2. Pokud stránka požádá o kód, zadejte kód do pole Device code přesně tak, jak jej Hermes zobrazuje, a poté klikněte na Continue.

  3. Pokud vás Meshy požádá o přihlášení, přihlaste se ke svému účtu Meshy.

  4. Na stránce Connect Meshy CLI klikněte na Connect. Stránka zobrazí Meshy CLI authorized.

    Stránka Connect Meshy CLI s přihlášeným účtem, přístupem, který CLI získá, a tlačítky Cancel a Connect

  5. Vraťte se do chatu. Hermes bude pokračovat v požadavku, který jste zadali.

Platnost kódu vyprší po 10 minutách. Pokud vyprší, požádejte Hermes o nový. Přihlášení můžete schválit z libovolného prohlížeče, takže to funguje i v případě, že Hermes běží na serveru nebo přes SSH.

Meshy CLI ukládá relaci do ~/.config/meshy/credentials.json. Každý agent, který běží pod stejným uživatelem na daném počítači, relaci sdílí. Pokud je nastavena proměnná MESHY_API_KEY, CLI použije místo relace v prohlížeči tento API klíč.


Příklady promptů

Popište úkol vlastními slovy. Například:

  • Vytvoř 3D model štěněte huskyho a ulož ho jako GLB do ./assets.
  • Proměň tuto fotku v texturovaný 3D model a zachovej jeho proporce. (přiložte obrázek)
  • Vytvoř pro mou hru tři low-poly lahvičky s lektvary, každou pod 1 500 trojúhelníků.
  • Vytvoř rig pro tuto humanoidní postavu, přidej animaci chůze a exportuj ji jako FBX.
  • Pomoz mi vytisknout malou figurku draka, 80 mm vysokou, jako vícebarevný 3MF.

Navazující požadavky využívají předchozí výsledek, například vytvoř LOD se 1 500 plochami, teď jako FBX nebo zmenši to na 150 mm. Pokud chcete každý placený krok schvalovat sami, přidejte do požadavku zeptej se mě, než utratíš kredity.


Řešení problémů

Následující tabulka uvádí běžné problémy, jejich příčiny a způsob jejich řešení.

ProblémPříčinaŘešení
Hermes nepoužívá dovednosti MeshyHermes nenačetl dovednosti v otevřené konverzaci, nebo váš požadavek k nim nepřiřadil.Spusťte novou relaci, nebo v požadavku zmiňte Meshy.
node nebo npm nebyly nalezenyNode.js není nainstalován, nebo ho Hermes nemůže najít.Nainstalujte Node.js verze 22.12 nebo novější z webu Node.js a poté Hermes restartujte.
Hermes žádá o API klíčDovednosti ho nepotřebují. Přihlašují se přes váš prohlížeč.Odmítněte a požádejte Hermes, ať se místo toho přihlásí přes prohlížeč. Nikdy nevkládejte API klíč do chatu.
Platnost přihlašovacího kódu vypršelaKód je platný 10 minut.Požádejte Hermes, aby přihlášení spustil znovu.
Hermes nemůže generovat kvůli vašemu plánu nebo kreditůmGenerování vyžaduje placený plán a dostatek kreditů.Zkontrolujte svůj plán a zůstatek na stránce Subscription ve webové aplikaci Meshy.
Jste přihlášeni ke špatnému účtu MeshyMeshy CLI znovu použije relaci uloženou na vašem počítači.Požádejte Hermes, aby spustil meshy auth logout, a poté se přihlaste znovu.

Časté dotazy

Jak přidám Meshy do Hermes Agent?
Požádejte Hermes, aby postupoval podle https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, nebo spusťte hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation a stejný příkaz pro meshy-3d-printing. Potřebujete také Node.js verze 22.12 nebo novější s npm.
Potřebuji API klíč Meshy?
Ne. Dovednosti se přihlašují přes váš prohlížeč pomocí jednorázového kódu a Meshy CLI relaci uloží. Pokud je ve vašem prostředí již nastavena proměnná MESHY_API_KEY, Meshy CLI ji použije místo toho.
Mohu nainstalovat jen dovednost pro 3D tisk?
Ano. meshy-3d-printing se instaluje a funguje samostatně, včetně generovacích kroků, které tisk potřebuje.
Funguje to, i když Hermes běží na vzdáleném serveru?
Ano. Přihlášení zobrazí odkaz a kód, které můžete schválit z libovolného prohlížeče.
Jsou to stejné dovednosti jako plugin pro Codex?
Ano. Plugin pro Codex, Claude Code, Cursor i Hermes Agent všechny používají meshy-3d-generation a meshy-3d-printing z open-source repozitáře meshy-3d-agent.
Je to zdarma?
Dovednosti jsou zdarma a open source. Generování 3D modelů vyžaduje placený plán Meshy a spotřebovává kredity Meshy podle API sazeb. Analýza tisknutelnosti je zdarma.