Run MotionCommons locally
Start the website and run your first synthetic analysis without a cloud account.
Requirements
Start in a local MotionCommons repository checkout. Use Node 24, npm, uv and Python 3.11 or later. Python 3.14.3 and Node 24.19.0 are the locally tested versions. The launcher and local module runner currently support macOS and Linux.
Select Node 24 in your shell before installing npm dependencies. The development launcher can discover an installed Node 24 for its child processes; it does not download a runtime.
Install and start
The launcher starts the web app on port 5173 and the API on port 8000, bound to loopback. Ctrl+C stops both child processes. Port conflicts are reported; choose an unused development setup rather than stopping unrelated services.
uv sync --locked --extra dev
npm ci
uv run python tools/dev.pyOpen an available app
- Open Public apps to see the tools available without an invitation.
- Choose OpenSim to work with supported models and motion files on this device.
- Use the app’s own workflow. Opening a public app does not publish local files or study records.
Add a workspace or module
The public website, documentation and local OpenSim tools need no account. Sign-in and the study workspace require matching Supabase configuration. Use synthetic records in development.