🛠️ 安装 Python SDK

安装要求

• Python 版本：<3.14,>=3.10

  Python 版本	支持状态
  ≤ 3.9	❌
  3.10 ～ 3.13	✅
  ≥ 3.14	❌

• 包管理器：pip 23.0+ （推荐使用 uv / pdm / poetry 等项目管理工具）

• 系统及架构：

  • Windows(x86_64)

  • Linux(x86_64)

  • MacOS(aarch64)

  备注

  各平台支持的功能如下：

  操作系统	CPU 仿真	交互式查看器	GPU 仿真
  Linux	✅	✅	🛠️ 开发中
  Windows	✅	✅	🛠️ 开发中
  MacOS	✅	✅	🛠️ 开发中

  备注

  在 MacOS (aarch64-apple-darwin) 平台上，当使用 🎨 渲染器（RenderApp） 相关功能时，需要使用以下命令格式：

  uv run mxpython your_script.py
  

  这是由于 MacOS ARM64 平台上 RenderApp 的特殊性要求，使用 uv run mxpython 可以确保正确加载渲染相关的依赖和执行环境。

  重要说明：

  • 如果你的代码使用了 🎨 渲染器（RenderApp），则需要使用 uv run mxpython

  • 如果你的代码不使用 RenderApp（例如：仅进行物理仿真计算，没有渲染窗口），则使用 uv run 即可，与 Windows 和 Linux 平台一致

安装方法

使用 pip

pip install motrixsim

使用 uv

uv add motrixsim

使用 pdm

pdm add motrixsim

使用 poetry

poetry add motrixsim

验证安装

使用 pip

pip show motrixsim

使用 uv

uv pip list | grep motrixsim

使用 pdm

pdm list | grep motrixsim

使用 poetry

poetry show | grep motrixsim