https://github.com/jurmy24/mechaverse
A universal web-based viewer for URDF, SDF, MJCF, and OpenUSD robots—just drag, drop, and explore in 3D.
https://github.com/jurmy24/mechaverse
mjcf openusd robotics sdf-viewer urdf-visualizer wasm
Last synced: 20 days ago
JSON representation
A universal web-based viewer for URDF, SDF, MJCF, and OpenUSD robots—just drag, drop, and explore in 3D.
- Host: GitHub
- URL: https://github.com/jurmy24/mechaverse
- Owner: jurmy24
- License: mit
- Created: 2025-08-05T10:16:46.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-05T10:57:10.000Z (10 months ago)
- Last Synced: 2025-08-05T12:38:41.094Z (10 months ago)
- Topics: mjcf, openusd, robotics, sdf-viewer, urdf-visualizer, wasm
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mechaverse
**Mechaverse** is a universal 3D viewer for robot models and scenes. We currently support **URDF**, **MJCF**, and **OpenUSD** formats right in the browser. It looks best on the computer, where you can drag, drop, and inspect your robot models without any setup or installation required. However, we also support smaller screens but can't make any promises in rendering quality.
It's a simple **Next.js** project, where rendering is supported by Three.js. We designed the viewer as a dispatch service making use of some great work by other open-source projects like:
- **[mujoco_wasm](https://github.com/zalo/mujoco_wasm)** - MuJoCo physics engine in the browser via WebAssembly
- **[usd-viewer](https://github.com/needle-tools/usd-viewer)** - OpenUSD viewer with rich USDStage support
- **[urdf-loaders](https://github.com/gkjohnson/urdf-loaders/)** - Robust URDF loading for Three.js
### Installation
Here we use **bun** but you can also use **npm** or **yarn**
1. **Clone the repository**
2. **Install dependencies** `bun install`
3. **Start the development server** `bun run dev`
4. **Open your browser** at `http://localhost:3000`
## ⚠️ Disclaimer
**Work in Progress**: Mechaverse is in active development. We appreciate your support and feedback to improve the quality of the simulators and identify any errors.
- **USD Display Issues**: USD files may not display properly on some mobile devices (tested on Safari and Chrome)
- **Performance**: Complex models may experience performance issues on lower-end devices
- **Browser Compatibility**: Some features may not work in older browsers
---