Hermes Agent를 위한 Meshy 스킬

Hermes Agent를 위한 공식 Meshy 스킬을 사용하면 에이전트가 채팅만으로 3D 모델, 텍스처, 애니메이션을 생성하고 3D 프린팅을 준비할 수 있습니다.

소개

이제 Hermes Agent에서 Meshy를 사용할 수 있으며, 다음 두 가지 스킬이 제공됩니다:

  • meshy-3d-generation: 텍스트로 3D, 이미지로 3D, 멀티뷰로 3D 변환, AI 텍스처링 및 재텍스처링, 폴리곤 예산에 맞춘 리메시, UV 언래핑, 휴머노이드 캐릭터용 오토 리깅 및 애니메이션, GLB, FBX, OBJ, STL 또는 USDZ로의 내보내기를 제공합니다.
  • meshy-3d-printing: 프린팅 가능성 분석 및 복구, 단색 및 다색 3MF, 실제 치수에 맞춘 크기 조정, Creative Lab 제품(피규어, 조명, 키링, 냉장고 자석) 및 설치된 슬라이서로의 전달을 제공합니다.

각 스킬은 개별적으로 설치되므로, 프린팅만 필요하다면 해당 스킬만 추가할 수 있습니다. 두 스킬 모두 Meshy CLI를 사용합니다. 브라우저에서 한 번만 로그인하면 되며, API 키는 필요하지 않습니다.

요구 사항

  • Hermes Agent.
  • Node.js 22.12 이상, npm 포함, Hermes가 실행되는 기기에 설치되어 있어야 합니다.
  • 생성을 위한 유료 Meshy 요금제. 모든 생성 작업은 API 요금에 따라 Meshy 크레딧을 소비합니다. 프린팅 가능성 분석은 무료이며, 모델 크기 조정이나 슬라이서에서 열기와 같은 로컬 프린팅 단계에는 로그인이 필요하지 않습니다.

설치

가장 빠른 방법은 Hermes가 설정을 직접 하도록 하는 것입니다. 다음 내용을 채팅에 붙여넣으세요:

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

에이전트가 Node.js를 확인하고, Meshy CLI와 두 스킬을 설치한 뒤, 로그인 과정을 안내합니다.

직접 설치하려면 Hermes로 GitHub에서 스킬을 추가하세요:

hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation
hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-printing

또는 skills 설치 도구로 두 스킬을 한 번에 설치하세요:

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

전역 npm install -g meshy-cli는 선택 사항이며, 설치하지 않으면 스킬이 npm exec를 통해 CLI를 실행합니다. 설치 후에는 스킬이 로드되도록 새 Hermes 세션을 시작하세요.

로그인

처음으로 모델을 요청하면, 에이전트가 Meshy CLI의 기기 로그인을 실행하고 링크와 일회용 코드를 보내줍니다:

  1. 아무 기기에서나 링크를 열고 Meshy에 로그인합니다.
  2. 표시된 코드를 정확히 입력한 다음 Connect를 클릭합니다.
  3. 에이전트가 요청하신 작업을 이어서 진행합니다.

Connect Meshy CLI 페이지

코드는 10분 후 만료되므로, 만료되면 에이전트에게 새 코드를 요청하세요. 기기 로그인 방식은 어떤 브라우저에서도 작동하므로, Hermes가 서버나 SSH를 통해 실행되는 경우에도 사용할 수 있습니다. Meshy CLI는 세션을 ~/.config/meshy/credentials.json에 저장하며, 같은 사용자 계정의 모든 에이전트와 이를 공유합니다. MESHY_API_KEY가 설정되어 있으면 브라우저 세션보다 우선합니다.

예시 프롬프트

  • 아기 허스키의 3D 모델을 만들어서 ./assets에 GLB로 저장해줘.
  • 이 사진을 텍스처가 적용된 3D 모델로 만들고 비율을 유지해줘. (이미지 첨부)
  • 내 게임을 위한 로우폴리 물약 병 3개를 만들어줘, 각각 1,500 삼각형 이하로.
  • 이 휴머노이드 캐릭터를 리깅하고 걷기 애니메이션을 추가한 다음 FBX로 내보내줘.
  • 작은 용 피규어를 80mm 높이의 다색 3MF로 3D 프린팅할 수 있게 도와줘.

후속 요청은 이전 결과를 재사용합니다: 1,500면짜리 LOD로 만들어줘, 이번엔 FBX로, 150mm로 크기 조정해줘. 크레딧을 쓰기 전에 나한테 물어봐를 추가하면 유료 단계마다 승인을 받을 수 있습니다.

문제 해결

증상해결 방법
Hermes가 Meshy 스킬을 사용하지 않음설치 후 새 세션을 시작하거나, 요청에 Meshy를 언급하세요.
node 또는 npm을 찾을 수 없음nodejs.org에서 Node.js 22.12 이상을 설치한 다음 Hermes를 재시작하세요.
에이전트가 API 키를 요청함거부하고 대신 브라우저를 통해 로그인하도록 요청하세요. 채팅에 API 키를 절대 붙여넣지 마세요.
로그인 코드가 만료됨에이전트에게 로그인을 다시 시작하도록 요청하세요. 코드는 10분 동안 유효합니다.
요금제나 크레딧 부족으로 생성이 거부됨생성에는 유료 요금제와 충분한 크레딧이 필요합니다. meshy.ai에서 요금제와 잔액을 확인하세요.
잘못된 Meshy 계정으로 로그인됨에이전트에게 meshy auth logout을 실행하도록 요청한 다음 다시 로그인하세요.

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.

관련 링크