google-deepmind/mujoco_menagerie

MuJoCo Menagerie – MuJoCo物理エンジン向け高品質ロボットモデル

概要 – 多種多様なロボットやバイオメカニクスシステム（人型、四足歩行、アーム、ドローンなど）のMJCF (MuJoCo XML) モデルファイルの厳選ライブラリです。これらのモデルはGoogle DeepMindによって作成・保守されており、Pythonライブラリ (mujoco-menagerie) としてパッケージ化されています。

重要性 – シミュレーションにおいて、ロボットモデルの忠実度は、制御、強化学習、ロボット工学、具現化AI（Embodied AI）の研究における結果の有用性を左右します。Menagerieは、MuJoCoで正しく読み込み・実行できることが確認された、ドキュメントが整備された即戦力のモデルを提供し、ユーザーがXMLファイルをゼロから作成する手間やエラーのリスクを軽減します。

使い方

• パッケージのインストール: pip install mujoco-menagerie
• Pythonでのモデル読み込み:

  import mujoco_menagerie as mm
  model = mm.load('unitree_go2')   # シーンのダウンロードとコンパイル
  spec = mm.get('unitree_go2').spec()  # 編集可能な MuJoCo MjSpec オブジェクト
  

• インストールなしでコマンドラインからモデルを表示: uvx mujoco-menagerie view unitree_go2
• または、リポジトリから直接組み込みビューアを実行: python -m mujoco.viewer --mjcf mujoco_menagerie/unitree_go2/scene.xml

内容 – 40種類以上のロボット定義が含まれており、各フォルダには以下が含まれます:

• assets/: 視覚および衝突ジオメトリ用のメッシュファイル
• *.xml (MJCF): ロボットの運動学ツリーを記述
• scene.xml: 地面、照明などを追加
• 新しい MuJoCo-X バックエンド用のオプションの MJX 互換 XML ファイル
• PNG プレビューと生成詳細を含む README
• ライセンス情報 (ほとんどが BSD-3-Clause、Apache-2.0、または MIT)

品質評価 – モデルには、パラメータが実際のハードウェアとどの程度一致しているかを示す暫定的な評価 (A+, A, B, C) が割り当てられています。この評価システムは、体系的な識別ツールボックスがリリースされた後に改良される予定です。

コミュニティ – 貢献を歓迎します。リポジトリには pre-commit フックを設定する make install ステップが含まれており、make all を実行すると CI と同じチェック（lint、フォーマット、ライセンス準拠、XML 検証、テスト）が実行されます。

Menagerieの活用シーン – MuJoCoベースの研究（強化学習エージェント、軌道最適化、Sim-to-Real転移など）で信頼性の高いロボットモデルが必要な場合、Menagerieは最小限のセットアップでプラグアンドプレイな出発点を提供します。

---

主要リンク

• PyPI package
• Live in-browser viewer (README内のサムネイルをクリック)
• GitHub repo
• Contribution guide