Project SuperDex
A unified platform for dexterous manipulation research
Welcome to Project SuperDex.
SuperDex brings together a purpose-built physics engine, robotics authoring
tools, and a scalable reinforcement learning interface in a unified simulation
platform, with VR-based teleoperation and additional capabilities planned for
future releases.
Visit the Project SuperDex website for more.
| Threaded Screw |
Manipulation |
 |
 |
Building blocks
- SuperDex Physics — A contact-first physics engine purpose-built for tactile
manipulation, and applicable wherever stable contact and accurate sensing
matter. This is the simulation backbone of Project SuperDex.
- SuperDex Robotics — A robotics SDK that provides robot definitions and
composition, controllers, sensors, actuators, and the framework that
aggregates them into complete simulation configs.
- SuperDex Studio — A lightweight desktop GUI authoring and visualization
application for creating, editing, and validating the simulation assets —
robots, meshes, task prefabs, and scenes.
- SuperDex Lab — The simulation harness that abstracts the Markov decision
process and dynamics-constrained-optimization underpinning RL, MPC, and
system-ID.
Gallery
The following videos were recorded in real-time using SuperDex Teleop (available in Q4 2026).
| Soft Sponge |
Fruit Bag |
 |
 |
| Cereal Box |
Rope Braid |
 |
 |
| Contact Viz |
Puzzle Cube |
 |
 |
| Compose Bots |
Soft Fingertips |
 |
 |
SuperDex Studio
SuperDex Studio is the desktop application where you turn raw CAD and robot descriptions into native SuperDex Assets - bots, prefabs, and scenes. This is the GUI toolkit of Project SuperDex.
Click to learn more about SuperDex Studio.
| SuperDex Studio |
Apply Forces |
 |
 |
SuperDex Lab (early preview)
SuperDex Lab connects simulation and policy development through a Gymnasium-style API for reinforcement learning. It is currently in early preview and will receive substantial improvements.
Click to learn more about SuperDex Lab.
Q4 2026: SuperDex Teleop
SuperDex Teleop is the next major module coming to Project SuperDex. Initial components for Unreal Engine 5 based virtual teleoperation will be available in Q4 2026.
SuperDex Teleop runs natively on-device on Quest 3. No remote PC, no streaming. Includes support for both hand tracking and controllers including mixed mode. Runs in pure C++ for low-latency, real-time, scalable virtual teleop.
Requirements
- OS: Linux (x86_64), Windows (x86_64), macOS (ARM)
- Python 3.12
- Pre-built wheels are currently provided only for Python3.12. More flexible abi3 wheels will be available in a future release.
Get the Source Code and Examples
- Clone:
git clone --branch stable https://github.com/facebookresearch/project_superdex.git
- Note:
stable branch always matches latest published release
Quick Start (Python)
Project SuperDex has first-class support for Python across the board. The quickest way to get started is with uv and pypi wheels.
- Install pre-requisites
- uv
- Linux Only:
SuperDex Studio and SuperDex Physics Debugger require an available X11 display (native X11 or XWayland), a graphics driver supporting OpenGL 4.1, and the following runtime components:
- Ubuntu/Debian:
sudo apt install libgl1 libx11-6 libx11-xcb1 libxcb1 libxext6 libxrandr2 libxinerama1 libxcursor1 libxi6 zenity
- Fedora/RHEL:
sudo dnf install libglvnd-glx libX11 libX11-xcb libxcb libXext libXrandr libXinerama libXcursor libXi zenity
cd into the project_superdex source directory- Create venv
uv venv
- Pip Install:
uv pip install superdex
- Run
- Optional: To run Python examples in double precision (float64), set the environment variable
SUPERDEX_PRECISION=double; otherwise, single precision is used.
- Physics example:
uv run --no-project superdex_physics/examples/example_tendon_comparison.py
- Robotics example:
uv run --no-project superdex_robotics/examples/control/example_osc_jsc_control.py
- SuperDex Studio:
uv run --no-project superdex-studio
- Note:
--no-project is required for uv run cmds within this repo or else it will build from source
Building from Source
Install Pre-requisites
- CMake (v3.25 or newer)
- Ninja
- uv (for Python build)
- Linux:
Clang (v17 or newer):
- Check your installed version:
clang --version. The executable may be versioned instead (for example, clang-22 --version).
- If needed, install Clang:
Before building, set CC and CXX to the Clang executables you verified above so CMake uses them.
Choose one:
# Unversioned executables
export CC=clang
export CXX=clang++
# Versioned executables: set this to your installed major version (17 or newer)
CLANG_VERSION=22
export CC="clang-${CLANG_VERSION}"
export CXX="clang++-${CLANG_VERSION}"
NOTE: If CMake already configured the build directory with different compilers, delete the build directory before trying again because CMake caches its compiler selection.
SuperDex Studio and SuperDex Physics Debugger source builds (uv sync --extra gui) additionally require:
- Ubuntu/Debian:
sudo apt install libx11-dev libxext-dev libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev libxcb1-dev libgl1-mesa-dev
- Fedora/RHEL:
sudo dnf install libX11-devel libXext-devel libXrandr-devel libXinerama-devel libXcursor-devel libXi-devel libxcb-devel mesa-libGL-devel
- macOS:
- Install Xcode Command Line Tools for Xcode 26 or newer:
xcode-select --install
- Check "Software Update" for the latest version if already installed.
- Windows:
- MSVC Build Tools for VS2022 or newer (Visual Studio IDE is not necessary)
- Select the Desktop development with C++ workload and include the C++ Clang tools for Windows (ClangCL) component.
- Or install from terminal:
winget install --exact --id Microsoft.VisualStudio.2022.BuildTools --override "--wait --passive --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100"
- Ensure
cmake, ninja, uv, and the platform-specific Clang compiler are on PATH: clang and clang++ on Linux/macOS (versioned names such as clang-17 and clang++-17 are also supported), or clang-cl on Windows.
- Other compilers such as GCC and MSVC are not officially supported or covered by CI, but can be used "at your own risk".
Building from Source (Python)
- Get the source code and install pre-requisites (see above)
- Windows only: From the Start menu, launch the
x64 Native Tools Command Prompt matching your installed Visual Studio version (e.g. x64 Native Tools Command Prompt for VS 2022).
cd into the project_superdex source directory- Build:
uv sync --extra gui -v
- Run:
- Physics example:
uv run superdex_physics/examples/example_tendon_comparison.py
- Robotics example:
uv run superdex_robotics/examples/control/example_osc_jsc_control.py
- SuperDex Studio:
uv run superdex-studio
Flags for uv sync are:
| uv sync flags (additive) |
Build targets |
| none |
build tools only |
--extra core |
physics, robotics, lab |
--extra gui |
core + physics-debugger, studio, mesh-cli |
--extra double |
core + physics-fp64, robotics-fp64 |
--all-extras |
everything |
NOTE: Running the examples above requires --extra gui.
NOTE: --extra double builds the double-precision bindings, but single precision is still the default at runtime. To run Python examples in double precision, set the environment variable SUPERDEX_PRECISION=double.
Building from Source (C++)
Core modules such as SuperDex Physics and SuperDex Robotics are written in C++ and exposed to Python. Full C++ examples will be shared in the future. Users who are interested in calling C++ directly can get started via CMake.
- Get the source code and install pre-requisites (see above)
- Windows only: From the Start menu, launch the
x64 Native Tools Command Prompt matching your installed Visual Studio version (e.g. x64 Native Tools Command Prompt for VS 2022).
cd into the project_superdex source directory- Configure lean Release build:
cmake -B build -DCMAKE_BUILD_TYPE=Release -DMOCHI_BUILD_DEBUGGER=OFF -DMOCHI_USE_PYBIND=OFF -G Ninja
- Build:
cmake --build build --parallel
NOTE: To build the C++ libraries in double precision, add -DMOCHI_USE_DOUBLE_PRECISION=ON when configuring CMake. Otherwise, single precision will be used by default.
Documentation
Documentation, getting started guides, and examples are available for all modules.
How to Contribute
We welcome contributions! Go to CONTRIBUTING and our CODE OF CONDUCT for how to get started.
Reporting Issues
Please report issues via GitHub Issues.
License
First-party SuperDex source code is licensed under Apache 2.0. Assets and documentation are licensed under CC-BY-4.0 except where otherwise noted. Third-party and derived code and assets retain their own terms, recorded in their accompanying LICENSE and NOTICE files. superdex_mesh_cli is an optional, standalone mesh processing CLI tool released under GPLv3 due to use of OCCT and CGAL.
Third-party license families represented in this repository include Apache-2.0, BSD-2-Clause, BSD-3-Clause, BSL-1.0, CC-BY-4.0, CC0-1.0, GPL-3.0-or-later, LGPL-2.1 with the OCCT exception, LGPL-3.0-or-later, MIT, MPL-2.0, SIL OFL-1.1, HDF5, libpng, public-domain, zlib, Zstandard, and component-specific commercial or asset terms. The accompanying license and notice files are authoritative for each component or asset.
Certain third party dependencies and third party assets in this repo are licensed for non-commercial/academic uses only. You must ensure that you, as the user, access and use such third party dependencies and assets in compliance with their respective licenses.
Citation
Citation details will be added here upon publication.
Project SuperDex 是 Meta 推出的灵巧操作研究统一仿真平台，结合了以接触为先的物理引擎、机器人创作工具和强化学习接口，基于 VR 的遥操作计划于 2026 年第四季度推出。