DocumentationMotionCommons · Developer preview

Run MotionCommons locally

Developer preview

Start the website and run your first synthetic analysis without a cloud account.

Docs/Get started
Ask Claude

Run MotionCommons locally

Page Markdown

The complete guide, ready to copy or save as a Markdown file.

Download .md ↓

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.

sh
uv sync --locked --extra dev
npm ci
uv run python tools/dev.py

Open an available app

  1. Open Public apps to see the tools available without an invitation.
  2. Choose OpenSim to work with supported models and motion files on this device.
  3. 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.

Accessibility

Make every MotionCommons page comfortable for you. Settings apply on this browser.

Text size

Your training, at your pace.

Reading & movement
Audio support

Spoken audio is unavailable in this browser. All instructions remain available as text.

Read this page speaks up to 1,800 characters of visible page text. Embedded dashboards have their own Read dashboard button.