Real2Motrix

Capture the real world. Export a simulation scene.

Overview · Quick start · Workflow · Validation · Docs

English · 简体中文

---

Overview

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.

Alpha, local-only. This is not a production scanning service. Phone capture is experimental; trajectory coverage is not surface completeness. There is no 3DGS training/rendering pipeline. See the roadmap for acceptance criteria and SECURITY.md before using a network connection.

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.

Local demo

Original synthetic mesh exported and validated through the local API and worker.

Watch the 51-second introduction · Douyin · Download the Alpha and demo assets · Launch announcement on X

The introduction uses real software capture with original synthetic geometry and synthetic narration. It is not evidence of real-world scan quality.

Quick start

Tested toolchain: Python 3.12 and Node 24. Native reconstruction dependencies are not required for the synthetic mesh demo.

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.py

Workflow

CAPTURE → 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 dev

Validation

cd backend && ../.venv/bin/python -m pytest
cd ../frontend && npm test && npm run build

Recorded 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.

Docs

• Pipeline / 流水线
• Backend tests / 后端测试
• iOS release / iOS 发布
• Contributing
• Roadmap and known limitations
• Launch evidence and video

License and provenance

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.