facebookresearch/project_superdex

Project SuperDex – 用于灵巧操作的仿真平台

简介 – Project SuperDex 是一套专注于研究的仿真套件，整合了接触丰富的物理引擎、机器人 SDK、可视化创作工具以及强化学习接口。它旨在研究和开发灵巧、触觉操作的算法，包括 RL、模型预测控制 (MPC) 和系统识别。

核心组件

• SuperDex Physics – 一个“接触优先”的引擎，优先考虑稳定的接触和精确的力/力矩感测，这对于仿真精细操作至关重要。
• SuperDex Robotics – 定义机器人（运动学、传感器、执行器）并让您将它们组合成完整的仿真配置。
• SuperDex Studio – 一个轻量级桌面 GUI，用于将 CAD 模型和机器人描述转换为原生的 SuperDex 资源（机器人、预制件、场景）并进行可视化。
• SuperDex Lab – 一个 Gymnasium 风格的 Python API，将仿真公开为 MDP，从而实现强化学习、MPC 和系统识别实验。
• SuperDex Teleop (计划于 2026 年第四季推出) – 一个基于 Unreal-Engine-5 的虚拟现实远程操作模块，可在 Quest 3 上以低延迟的 C++ 代码原生运行。

重要性 – 灵巧操作对于机器人和具身 AI 来说仍然是一个难题。现有的仿真器通常难以处理稳定的接触，或缺乏与学习流程的紧密整合。SuperDex 旨在通过提供以下功能来填补这一空白：

• 适用于触觉任务的精确接触动力学。
• 端到端 Python 绑定，让研究人员可以直接从 Python 原型设计策略，同时在优化的 C++ 中执行繁重的工作。
• 可视化创作工作流程 (Studio)，加快创建新机器人、物体和任务场景的速度。
• 清晰的 RL 接口 (Gymnasium 风格)，让您可以插入任何 RL 库。

入门指南 (Python)

1. 安装辅助工具 uv 和所需的系统库（OpenGL 4.1、Linux 上的 X11、macOS 上的 Xcode 工具，或 Windows 上的 MSVC + Clang）。
2. 克隆 repo 的 stable 分支。
3. 在源代码目录内：

   uv venv                     # 创建虚拟环境
   uv pip install superdex    # 安装预先构建的 wheels (目前仅支持 Python 3.12)
   

4. 运行提供的示例，例如：

   uv run --no-project superdex_physics/examples/example_tendon_comparison.py
   uv run --no-project superdex_robotics/examples/control/example_osc_jsc_control.py
   uv run --no-project superdex-studio   # 启动 GUI 创作工具
   

   如果需要，设置 SUPERDEX_PRECISION=double 以切换到双精度计算。

从源代码构建 – 如果您需要自定义构建（例如双精度、额外的 GUI 工具或仅 C++ 的库），README 提供了逐步的 CMake/Ninja 工作流程。该项目首选 Clang ≥ 17（或 Linux 上的 Clang 22），但您也可以自行承担风险使用其他编译器。

文档与资源 – 每个模块的详细文档托管在项目网站上：

• Physics: projectsuperdex.com/physics/docs/overview/
• Robotics: projectsuperdex.com/robotics/docs/overview/
• Studio: projectsuperdex.com/studio/docs/overview/
• Lab: projectsuperdex.com/lab/docs/overview/

授权 – 核心代码采用 Apache 2.0。资源和文档采用 CC-BY-4.0，部分可选工具（例如 superdex_mesh_cli）因第三方依赖而采用 GPL 3.0。

引用 – 如果您发表使用 SuperDex 的研究成果，请引用提供的 arXiv 风格参考文献。

---

Project SuperDex 是一个真正的研究级机器人仿真平台，旨在为从事灵巧操作的 AI 和机器学习从业者提供服务。