Hermes Agent向けMeshyスキル

Hermes Agent向けの公式Meshyスキルを使うと、チャットだけでエージェントに3Dモデル、テクスチャ、アニメーションを生成させたり、3Dプリントの準備をさせたりできます。

概要

Meshyは現在、Hermes Agent向けに2つのスキルとして利用できます。

  • meshy-3d-generation: テキストから3D、画像から3D、マルチビューから3D、AIによるテクスチャリングとリテクスチャリング、ポリゴン数の目標値へのリメッシュ、UV展開、ヒューマノイドキャラクター向けの自動リギングとアニメーション、GLB、FBX、OBJ、STL、USDZへの書き出しに対応しています。
  • meshy-3d-printing: プリント可能性の分析と修復、単色および多色の3MF出力、実寸サイズへのサイズ調整、Creative Lab製品（フィギュア、ランプ、キーホルダー、冷蔵庫マグネット）、インストール済みスライサーへの連携に対応しています。

各スキルは個別にインストールできるため、プリント関連の機能だけが必要な場合はそのスキルのみを追加できます。どちらのスキルもMeshy CLIを利用します。ブラウザで一度サインインするだけで利用でき、APIキーは必要ありません。

必要要件

  • 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

エージェントが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 page

コードは10分で期限切れになります。期限切れの場合は、エージェントに新しいコードを依頼してください。デバイスフローはどのブラウザでも機能するため、Hermesをサーバー上やSSH経由で実行している場合でも利用できます。Meshy CLIはセッションを~/.config/meshy/credentials.jsonに保存し、同じユーザーアカウント上のすべてのエージェントと共有します。MESHY_API_KEYが設定されている場合は、ブラウザセッションよりもそちらが優先されます。

プロンプト例

  • 子犬のハスキーの3Dモデルを作って、./assetsにGLBとして保存して。
  • この写真をテクスチャ付きの3Dモデルに変換して、プロポーションはそのまま保って。（画像を添付）
  • 自分のゲーム用に、1,500ポリゴン未満のローポリなポーションボトルを3種類作って。
  • このヒューマノイドキャラクターにリグを設定して、歩行アニメーションを追加し、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.

関連リンク