Metadata-Version: 2.4
Name: superdex-physics-debugger
Version: 1.0.0
Summary: Standalone debugger UI for SuperDex physics scenes
Author: SuperDex Team
License-Expression: Apache-2.0
License-File: LICENSE
License-File: thirdparty_licenses/cityhash/LICENSE
License-File: thirdparty_licenses/eigen/COPYING.APACHE
License-File: thirdparty_licenses/eigen/COPYING.BSD
License-File: thirdparty_licenses/eigen/COPYING.MINPACK
License-File: thirdparty_licenses/eigen/COPYING.MPL2
License-File: thirdparty_licenses/eigen/COPYING.README
License-File: thirdparty_licenses/eigen/LICENSE
License-File: thirdparty_licenses/filament/LICENSE
License-File: thirdparty_licenses/filament-basisu/APACHE-2.0.txt
License-File: thirdparty_licenses/filament-basisu/BSD.txt
License-File: thirdparty_licenses/filament-basisu/LICENSE
License-File: thirdparty_licenses/filament-basisu/ZLIB.txt
License-File: thirdparty_licenses/filament-basisu/ZSTD_LICENSE
License-File: thirdparty_licenses/filament-cgltf/LICENSE
License-File: thirdparty_licenses/filament-draco/LICENSE
License-File: thirdparty_licenses/filament-fsr/LICENSE
License-File: thirdparty_licenses/filament-libpng/LICENSE
License-File: thirdparty_licenses/filament-meshoptimizer/LICENSE
License-File: thirdparty_licenses/filament-mikktspace/LICENSE
License-File: thirdparty_licenses/filament-robin-map/LICENSE
License-File: thirdparty_licenses/filament-sgsr/LICENSE
License-File: thirdparty_licenses/filament-smol-v/LICENSE
License-File: thirdparty_licenses/filament-spirv-headers/LICENSE
License-File: thirdparty_licenses/filament-stb/LICENSE
License-File: thirdparty_licenses/filament-tinyexr/LICENSE
License-File: thirdparty_licenses/filament-vkmemalloc/LICENSE.txt
License-File: thirdparty_licenses/glad/KHRONOS_LICENSE
License-File: thirdparty_licenses/glad/LICENSE
License-File: thirdparty_licenses/glfw/LICENSE.md
License-File: thirdparty_licenses/happly/LICENSE
License-File: thirdparty_licenses/hdf5/COPYING
License-File: thirdparty_licenses/hdf5/COPYING_LBNL_HDF5
License-File: thirdparty_licenses/imgui/LICENSE.txt
License-File: thirdparty_licenses/implot/LICENSE
License-File: thirdparty_licenses/marl/LICENSE
License-File: thirdparty_licenses/native-fonts/FONT_AWESOME_LICENSE.txt
License-File: thirdparty_licenses/native-fonts/ROBOTO_APACHE-2.0.txt
License-File: thirdparty_licenses/NOTICE.md
License-File: thirdparty_licenses/picojson/LICENSE
License-File: thirdparty_licenses/stl_reader/LICENSE
License-File: thirdparty_licenses/tiny_obj_loader/LICENSE
License-File: thirdparty_licenses/tinyxml2/LICENSE
License-File: thirdparty_licenses/zlib/LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Project-URL: Homepage, https://github.com/facebookresearch/project_superdex
Project-URL: Repository, https://github.com/facebookresearch/project_superdex
Requires-Python: <3.13,>=3.12
Description-Content-Type: text/markdown

# SuperDex Physics Debugger

A standalone debugger UI for inspecting
[SuperDex Physics](https://facebookresearch.github.io/project_superdex/physics/) scenes.

## Usage

Run it without installing anything:

```bash
uvx superdex-physics-debugger
```

Or install it so it stays around:

```bash
pip install superdex-physics-debugger
superdex-physics-debugger
```

## Why it ships on its own

The debugger connects to an already-running simulation over TCP instead of importing the Python
API, so it has no dependencies of its own, not even `superdex-physics`. That is what makes the
`uvx` command above work: uv can build a throwaway environment that contains only this wheel.

Nothing depends on the debugger either. `superdex-physics` does not require it, so you can debug
a simulation from a machine that has no SuperDex installed at all.

## Running the executable directly

The `superdex-physics-debugger` command is a thin launcher around `mochi_debugger`, which ships
inside the package:

```
<site-packages>/superdex_physics_debugger/_native/mochi_debugger
```

Its shared libraries sit next to it and are found through its RPATH, so you can launch this
binary directly instead of going through the command.

## License

The first-party code in this package is licensed Apache-2.0; see
[LICENSE](https://github.com/facebookresearch/project_superdex/blob/main/LICENSE).
All third-party code and dependencies keep their own licenses.
