Capture the real world. Export a simulation scene.
Overview · Quick start · Workflow · Validation · Docs
A local toolchain for ARKit capture, mesh processing and MJCF / URDF scene packaging. Start with an original synthetic mesh, then add reconstruction tools as your input type requires.
| Capability | What it provides |
|---|---|
| Native capture | SwiftUI / ARKit source; real devices require Xcode and signing. |
| Local processing | FastAPI, SQLite and an independent Python worker. |
| Scene export | Visual/collision meshes, MJCF, URDF, metadata and ZIP validation. |
Original synthetic mesh exported and validated through the local API and worker.
git clone https://github.com/eust-w/Real2Motrix.git
cd Real2Motrix
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -r backend/requirements-dev.txt
python scripts/synthetic_demo.pyCAPTURE → RECONSTRUCT → EXPORT
# In separate terminals, with the virtual environment active:
cd backend && python -m app.main
cd backend && python -m app.worker
cd frontend && npm ci && npm run devcd backend && ../.venv/bin/python -m pytest
cd ../frontend && npm test && npm run buildRecorded environment and executed checks: validation notes.
| Area | Current boundary |
|---|---|
| Synthetic mesh | The bundled demo creates original geometry and validates XML / URDF / JSON / ZIP. |
| Reconstruction | COLMAP / OpenMVS / Blender / Open3D are optional native dependencies; image tests using fake commands do not verify real reconstruction. |
| iOS | Real-device capture, signing and TestFlight are separate acceptance steps. |
Original code and newly created demo assets are licensed under Apache-2.0. Dependencies, models, datasets and external resources retain their terms; see THIRD_PARTY_NOTICES.md.