Umiejętności Meshy dla Hermes Agent

Oficjalne umiejętności (skills) Meshy dla Hermes Agent pozwalają Twojemu agentowi generować modele 3D, tekstury i animacje oraz przygotowywać modele do druku 3D — wszystko z poziomu czatu.

Przegląd

Meshy jest teraz dostępne dla Hermes Agent w postaci dwóch umiejętności:

  • meshy-3d-generation: tekst na 3D, obraz na 3D oraz wiele widoków na 3D, teksturowanie i retexturing z użyciem AI, remesh do zadanego budżetu wielokątów, UV unwrapping, automatyczny rigging i animacja postaci humanoidalnych oraz eksport do GLB, FBX, OBJ, STL lub USDZ.
  • meshy-3d-printing: analiza i naprawa drukowalności, jednokolorowy i wielokolorowy 3MF, dopasowywanie rozmiaru do rzeczywistych wymiarów, produkty Creative Lab (figurki, lampy, breloczki, magnesy na lodówkę) oraz przekazywanie danych do zainstalowanego slicera.

Każda umiejętność instaluje się niezależnie, więc możesz dodać tylko funkcję druku, jeśli to wszystko, czego potrzebujesz. Obie korzystają z Meshy CLI. Logujesz się raz w przeglądarce — nie jest wymagany klucz API.

Wymagania

  • Hermes Agent.
  • Node.js 22.12 lub nowszy, wraz z npm, na maszynie, na której działa Hermes.
  • Płatny plan Meshy do generowania. Każde zadanie generowania zużywa kredyty Meshy według stawek API. Analiza drukowalności jest bezpłatna, a lokalne kroki związane z drukiem, takie jak przeskalowanie modelu lub otwarcie go w slicerze, nie wymagają logowania.

Instalacja

Najszybszym sposobem jest pozwolenie, aby Hermes sam przeprowadził konfigurację. Wklej to do czatu:

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

Agent sprawdza Node.js, instaluje Meshy CLI oraz obie umiejętności, a następnie przeprowadza Cię przez proces logowania.

Aby zainstalować ręcznie, dodaj umiejętności z GitHub za 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

Lub zainstaluj obie za pomocą instalatora skills:

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

Globalna instalacja npm install -g meshy-cli jest opcjonalna; bez niej umiejętności uruchamiają CLI przez npm exec. Po instalacji uruchom nową sesję Hermes, aby umiejętności zostały wczytane.

Logowanie

Przy pierwszej prośbie o model agent uruchamia logowanie urządzenia w Meshy CLI i wysyła Ci link oraz jednorazowy kod:

  1. Otwórz link na dowolnym urządzeniu i zaloguj się do Meshy.
  2. Wprowadź kod dokładnie tak, jak jest wyświetlony, a następnie kliknij Connect.
  3. Agent kontynuuje realizację Twojego żądania.

Strona łączenia Meshy CLI

Kod wygasa po 10 minutach; jeśli to nastąpi, poproś agenta o nowy. Proces logowania urządzenia działa z dowolnej przeglądarki, więc sprawdza się również, gdy Hermes działa na serwerze lub przez SSH. Meshy CLI zapisuje sesję w ~/.config/meshy/credentials.json i udostępnia ją każdemu agentowi działającemu na tym samym koncie użytkownika. Jeśli ustawiona jest zmienna MESHY_API_KEY, ma ona priorytet nad sesją przeglądarki.

Przykładowe polecenia

  • Stwórz model 3D szczeniaka husky i zapisz go jako GLB w ./assets.
  • Zamień to zdjęcie w teksturowany model 3D, zachowując proporcje. (dołącz obraz)
  • Stwórz trzy butelki z eliksirem w stylu low-poly do mojej gry, każda poniżej 1500 trójkątów.
  • Dodaj rig do tej postaci humanoidalnej, dodaj animację chodzenia i wyeksportuj jako FBX.
  • Pomóż mi wydrukować w 3D małą figurkę smoka o wysokości 80 mm, jako wielokolorowy 3MF.

Kolejne polecenia wykorzystują poprzedni wynik: zrób LOD z 1500 ścianami, teraz jako FBX, przeskaluj do 150 mm. Dodaj zapytaj mnie przed wydaniem kredytów, aby zatwierdzać każdy płatny krok.

Rozwiązywanie problemów

ObjawRozwiązanie
Hermes nie korzysta z umiejętności MeshyUruchom nową sesję po instalacji lub wspomnij o Meshy w swoim poleceniu.
Brak node lub npmZainstaluj Node.js 22.12 lub nowszy ze strony nodejs.org, a następnie uruchom ponownie Hermes.
Agent prosi o klucz APIOdmów i poproś go, aby zamiast tego zalogował się przez przeglądarkę. Nigdy nie wklejaj klucza API do czatu.
Kod logowania wygasłPoproś agenta o ponowne rozpoczęcie logowania. Kody są ważne przez 10 minut.
Generowanie jest odrzucane z powodu planu lub kredytówGenerowanie wymaga płatnego planu oraz wystarczającej liczby kredytów. Sprawdź swój plan i saldo na meshy.ai.
Zalogowano na niewłaściwe konto MeshyPoproś agenta o wykonanie meshy auth logout, a następnie zaloguj się ponownie.

FAQ

How do I add Meshy to Hermes Agent?
Ask Hermes to follow https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md, or run hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation and the same for meshy-3d-printing. You also need Node.js 22.12 or newer with npm.
Do I need a Meshy API key?
No. The skills sign in through your browser with a one-time code, and the Meshy CLI stores the session. If MESHY_API_KEY is already set in your environment, it takes priority.
Can I install only the 3D printing skill?
Yes. meshy-3d-printing installs and works on its own, including the generation steps a print needs.
Does it work when Hermes runs on a remote server?
Yes. The device sign-in shows a link and a code that you can approve from any browser.
Are these the same skills as the Codex plugin?
Yes. The Codex plugin, Claude Code, Cursor and Hermes Agent all use meshy-3d-generation and meshy-3d-printing from the open-source meshy-3d-agent repository.
Is it free?
The skills are free and open source. Generating 3D models requires a paid Meshy plan and spends Meshy credits at API rates. Printability analysis is free.

Powiązane linki