Hermes Agent에 Meshy를 추가하려면 어떻게 하나요?

Hermes에게 https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md 를 따르도록 요청하거나, hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation을 실행하고 meshy-3d-printing에도 같은 명령을 실행하세요. Node.js 22.12 이상과 npm도 필요합니다.

Meshy API 키가 필요한가요?

아니요. 이 스킬들은 일회용 코드로 브라우저를 통해 로그인하며, Meshy CLI가 세션을 저장합니다. 환경에 이미 MESHY_API_KEY가 설정되어 있으면 Meshy CLI가 그 대신 이를 사용합니다.

3D 프린팅 스킬만 설치할 수 있나요?

네. meshy-3d-printing은 프린트에 필요한 생성 단계를 포함하여 단독으로 설치 및 동작합니다.

Hermes가 원격 서버에서 실행될 때도 동작하나요?

네. 로그인 시 어떤 브라우저에서든 승인할 수 있는 링크와 코드가 표시됩니다.

이 스킬들은 Codex 플러그인과 같은 것인가요?

네. Codex 플러그인, Claude Code, Cursor, Hermes Agent는 모두 오픈 소스 meshy-3d-agent 저장소의 meshy-3d-generation 및 meshy-3d-printing을 사용합니다.

스킬 자체는 무료이며 오픈 소스입니다. 3D 모델 생성에는 유료 Meshy 플랜이 필요하며 API 요금에 따라 Meshy 크레딧을 소모합니다. 프린팅 가능성 분석은 무료입니다.

Hermes Agent용 Meshy 스킬

Hermes Agent에 Meshy 스킬을 추가하여 에이전트가 채팅을 통해 3D 모델, 텍스처, 애니메이션을 생성하고 3D 프린트를 준비할 수 있도록 합니다.

개요

Meshy는 Hermes Agent를 위한 두 가지 스킬을 제공합니다:

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

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

이 스킬들은 GitHub의 meshy-3d-agent 저장소에서 오픈 소스로 제공됩니다.

시작하기 전에

Hermes Agent가 필요합니다.
Hermes를 실행하는 컴퓨터에 Node.js 22.12 이상과 npm이 필요합니다.
모델을 생성하려면 유료 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

Hermes는 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가 스킬을 사용하지 않는다면, 새 세션을 시작하세요.

처음 모델을 요청하면 Hermes가 Meshy CLI 로그인을 시작하고 링크와 일회용 코드를 보냅니다.

로그인하려면 다음 단계를 따르세요:

아무 기기에서든 링크를 엽니다.
페이지에서 코드를 요청하면, Hermes가 보여준 그대로 Device code에 코드를 입력한 다음 Continue를 클릭합니다.
Meshy가 로그인을 요청하면 Meshy 계정으로 로그인합니다.
Connect Meshy CLI 페이지에서 Connect를 클릭합니다. 페이지에 Meshy CLI authorized가 표시됩니다.
채팅으로 돌아갑니다. Hermes가 요청한 작업을 이어서 진행합니다.

코드는 10분 후 만료됩니다. 만료되면 Hermes에게 새 코드를 요청하세요. 로그인 승인은 어떤 브라우저에서든 할 수 있으므로, Hermes가 서버나 SSH를 통해 실행되는 경우에도 동작합니다.

Meshy CLI는 세션을 ~/.config/meshy/credentials.json에 저장합니다. 해당 컴퓨터에서 같은 사용자로 실행되는 모든 에이전트는 이 세션을 공유합니다. MESHY_API_KEY가 설정되어 있으면 CLI는 브라우저 세션 대신 해당 API 키를 사용합니다.

예시 프롬프트

원하는 작업을 자신의 언어로 설명하세요. 예를 들면 다음과 같습니다:

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

후속 요청은 이전 결과를 재사용합니다. 예를 들어 1,500면 LOD로 만들어줘, 이제 FBX로, 150mm로 크기 조정해줘 같은 식입니다. 유료 단계마다 직접 승인하려면 요청에 크레딧을 쓰기 전에 물어봐줘를 추가하세요.

문제 해결

다음 표는 자주 발생하는 문제, 원인, 해결 방법을 정리한 것입니다.

문제	원인	해결 방법
Hermes가 Meshy 스킬을 사용하지 않음	Hermes가 열린 대화에서 스킬을 로드하지 않았거나, 요청과 스킬을 매칭하지 못했습니다.	새 세션을 시작하거나 요청에 Meshy를 언급하세요.
`node` 또는 `npm`을 찾을 수 없음	Node.js가 설치되어 있지 않거나 Hermes가 이를 찾지 못합니다.	Node.js 웹사이트에서 Node.js 22.12 이상을 설치한 다음 Hermes를 다시 시작하세요.
Hermes가 API 키를 요청함	이 스킬들은 API 키가 필요하지 않습니다. 브라우저를 통해 로그인합니다.	요청을 거부하고 대신 브라우저를 통해 로그인하도록 Hermes에게 요청하세요. 채팅에 API 키를 붙여넣지 마세요.
로그인 코드가 만료됨	코드는 10분 동안 유효합니다.	Hermes에게 로그인을 다시 시작하도록 요청하세요.
플랜이나 크레딧 문제로 Hermes가 생성하지 못함	생성에는 유료 플랜과 충분한 크레딧이 필요합니다.	Meshy 웹 앱의 Subscription 페이지에서 플랜과 잔액을 확인하세요.
잘못된 Meshy 계정으로 로그인되어 있음	Meshy CLI는 컴퓨터에 저장된 세션을 재사용합니다.	Hermes에게 `meshy auth logout`을 실행하도록 요청한 다음 다시 로그인하세요.

FAQ

Hermes Agent에 Meshy를 추가하려면 어떻게 하나요?: Hermes에게 https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md 를 따르도록 요청하거나, hermes skills install meshy-dev/meshy-3d-agent/skills/meshy-3d-generation을 실행하고 meshy-3d-printing에도 같은 명령을 실행하세요. Node.js 22.12 이상과 npm도 필요합니다.
Meshy API 키가 필요한가요?: 아니요. 이 스킬들은 일회용 코드로 브라우저를 통해 로그인하며, Meshy CLI가 세션을 저장합니다. 환경에 이미 MESHY_API_KEY가 설정되어 있으면 Meshy CLI가 그 대신 이를 사용합니다.
3D 프린팅 스킬만 설치할 수 있나요?: 네. meshy-3d-printing은 프린트에 필요한 생성 단계를 포함하여 단독으로 설치 및 동작합니다.
Hermes가 원격 서버에서 실행될 때도 동작하나요?: 네. 로그인 시 어떤 브라우저에서든 승인할 수 있는 링크와 코드가 표시됩니다.
이 스킬들은 Codex 플러그인과 같은 것인가요?: 네. Codex 플러그인, Claude Code, Cursor, Hermes Agent는 모두 오픈 소스 meshy-3d-agent 저장소의 meshy-3d-generation 및 meshy-3d-printing을 사용합니다.
무료인가요?: 스킬 자체는 무료이며 오픈 소스입니다. 3D 모델 생성에는 유료 Meshy 플랜이 필요하며 API 요금에 따라 Meshy 크레딧을 소모합니다. 프린팅 가능성 분석은 무료입니다.

Codex에서 동일한 스킬을 사용하려면 Codex용 Meshy 플러그인을 참고하세요.
OpenClaw에서 동일한 스킬을 사용하려면 OpenClaw용 Meshy 스킬을 참고하세요.
자신의 API 키로 AI 에이전트에서 Meshy API를 호출하려면 AI 연동을 참고하세요.