Metadata-Version: 2.4
Name: mujoco-mac-metal
Version: 0.3.0
Summary: Experimental generalized MuJoCo Metal contact-free stepping profile
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/keeeeenw/mujoco-mac-metal
Project-URL: Repository, https://github.com/keeeeenw/mujoco-mac-metal
Project-URL: Documentation, https://github.com/keeeeenw/mujoco-mac-metal/blob/main/metal/INSTALL.md
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3.12
Requires-Python: <3.13,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: mujoco==3.10.0
Requires-Dist: numpy<3,>=2
Requires-Dist: torch==2.9.1; sys_platform == "darwin" and platform_machine == "arm64"
Provides-Extra: metal
Requires-Dist: torch==2.9.1; extra == "metal"
Provides-Extra: test
Requires-Dist: absl-py; extra == "test"
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

# mujoco-mac-metal

An experimental generalized MuJoCo 3.10.0 stepping profile for Apple Silicon.
It provides contact-free native Metal stepping with applied forces, damping,
and scalar motors, exposed as the `mujoco_metal` Python module and
`mujoco-metal` command.

This is a narrow experimental profile. It does not implement contacts,
constraints, or the full MuJoCo feature set, and is not a replacement for
upstream MuJoCo. Visualization still uses upstream MuJoCo's OpenGL path.

Install on macOS arm64 with Python 3.12 using `pip install mujoco-mac-metal`.
The package selects PyTorch 2.9.1 by default on that platform. See the
[installation and doctor guide](https://github.com/keeeeenw/mujoco-mac-metal/blob/main/metal/INSTALL.md)
for qualification details and native GPU diagnostics. The
[project source](https://github.com/keeeeenw/mujoco-mac-metal/tree/main/metal)
contains examples and implementation details.
