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を実行しますが、これはnpm上の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のサインインを開始し、リンクとワンタイムコードを送信します。

サインインするには、次の手順に従ってください。

  1. 任意のデバイスでリンクを開きます。

  2. ページでコードの入力を求められた場合は、Hermesに表示されたとおりにデバイスコードにコードを入力し、続行をクリックします。

  3. Meshyからサインインを求められた場合は、Meshyアカウントにサインインします。

  4. Connect Meshy CLIページでConnectをクリックします。ページにMeshy CLI authorizedと表示されます。

    サインイン済みアカウント、CLIが取得するアクセス権、CancelおよびConnectボタンが表示されたConnect Meshy CLIページ

  5. チャットに戻ります。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連携を参照してください。