motion-studio 0.1.0__tar.gz

motion_studio-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Melissa Colin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

motion_studio-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+recursive-include motion_studio/static *
+include LICENSE README.md
+prune build
+global-exclude __pycache__
+global-exclude *.pyc

motion_studio-0.1.0/PKG-INFO

@@ -0,0 +1,295 @@
+Metadata-Version: 2.4
+Name: motion-studio
+Version: 0.1.0
+Summary: A clean, installable multi-person SMPL motion editor with pluggable auto-correction and metrics.
+Author-email: Melissa Colin <github@melissacolin.ai>
+License: MIT
+Project-URL: Homepage, https://github.com/melissa-colin/motion-studio
+Project-URL: Repository, https://github.com/melissa-colin/motion-studio
+Project-URL: Documentation, https://github.com/melissa-colin/motion-studio#readme
+Project-URL: Issues, https://github.com/melissa-colin/motion-studio/issues
+Keywords: smpl,motion,motion-capture,3d,animation,pose,dance,editor,visualization
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: flask>=3.0
+Provides-Extra: smpl
+Requires-Dist: torch; extra == "smpl"
+Requires-Dist: smplx; extra == "smpl"
+Provides-Extra: video
+Requires-Dist: pillow; extra == "video"
+Requires-Dist: torchvision; extra == "video"
+Requires-Dist: librosa; extra == "video"
+Requires-Dist: scipy; extra == "video"
+Provides-Extra: all
+Requires-Dist: torch; extra == "all"
+Requires-Dist: smplx; extra == "all"
+Requires-Dist: pillow; extra == "all"
+Requires-Dist: torchvision; extra == "all"
+Requires-Dist: librosa; extra == "all"
+Requires-Dist: scipy; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# Motion Studio
+
+[![PyPI version](https://img.shields.io/pypi/v/motion-studio.svg)](https://pypi.org/project/motion-studio/)
+[![Python versions](https://img.shields.io/pypi/pyversions/motion-studio.svg)](https://pypi.org/project/motion-studio/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![CI](https://github.com/melissa-colin/motion-studio/actions/workflows/ci.yml/badge.svg)](https://github.com/melissa-colin/motion-studio/actions/workflows/ci.yml)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-261230.svg)](https://github.com/astral-sh/ruff)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+A clean, installable **multi-person SMPL motion editor** for the browser, with
+a 3D view (Three.js), a video/music background, frame-by-frame pose editing,
+and **pluggable** auto-correction and metrics.
+
+It started as an internal pose editor for the AIOZ-GDANCE dataset and was
+rewritten as a small, modular, self-contained tool: no dependency on any
+external research repo, a single save-file format, and a plugin contract so you
+can drop in **your own** correction / metrics classes without touching the app.
+
+![Motion Studio — playing a clip over its source video while orbiting the camera](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/demo.gif)
+
+*Editing a multi-person clip: the SMPL motion and the source video play in sync while you orbit the camera.*
+
+---
+
+## Features
+
+- **3D editor**: skeleton + SMPL mesh, per-joint and whole-body editing, undo/redo.
+- **Video & music background**: place the source video in the scene (position,
+  scale, opacity, time offset), server-side background removal, audio playback
+  synced to the timeline.
+- **Floor**: estimate / edit / recompute the ground plane.
+- **Auto-correction & metrics**: run a correction pipeline and score the motion;
+  both are **plugins** (built-in by default, swappable for your own).
+- **One save file**: a `.motion` bundle holds the original motion, your edits,
+  the video, the music, placement parameters, comments and a metrics snapshot.
+- **Two ways to load**: open a single SMPL `.pkl` (with optional video/music),
+  or point at a whole `GDance/` folder and convert it into the workspace.
+
+---
+
+## Screenshots
+
+![The 3D editor](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/editor.png)
+*The 3D editor: multiple SMPL dancers (mesh + skeleton), per-joint and
+whole-body editing, the automatic corrector (a plugin), and the live metrics
+panel. One **Save (.motion)** button and an **Export (.pkl)** button.*
+
+![Video background](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/video.png)
+*The source video as a placeable background — position, scale, opacity, time
+offset and server-side background removal — to check the motion against the
+real footage.*
+
+![Estimated floor](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/floor.png)
+*The ground plane is estimated on load (RANSAC on foot contacts) and can be
+edited or recomputed.*
+
+![Empty start](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/empty.png)
+*On startup the editor is empty (no clip auto-loaded, no pop-up). From the
+**Clip** tab you choose: browse loaded clips, open a folder, or import a .pkl.*
+
+---
+
+## Install
+
+```bash
+pip install "motion-studio[all]"   # recommended: full feature set
+```
+
+`[all]` pulls in torch, smplx, torchvision, pillow, librosa and scipy — the SMPL
+forward kinematics, pose refit, built-in corrector/metrics, server-side
+background removal and music import. Narrower extras are available:
+
+```bash
+pip install motion-studio            # core only (numpy + flask): no SMPL/video
+pip install "motion-studio[smpl]"    # + torch, smplx
+pip install "motion-studio[video]"   # + pillow, torchvision, librosa, scipy
+pip install "motion-studio[dev]"     # + pytest, ruff, black, pre-commit
+```
+
+Requires Python >= 3.9. The SMPL body models are **not** shipped; point the tool
+at your local copy with `--smpl-dir`.
+
+## Run
+
+```bash
+motion-studio --workspace ~/MotionStudio --smpl-dir ~/smpl/models --port 8815
+# optional: import a raw dataset folder
+motion-studio --data /path/to/GDance --smpl-dir ~/smpl/models
+```
+
+Then open <http://127.0.0.1:8815>.
+
+The **workspace** is the root folder that holds your saved `.motion` bundles,
+like any desktop app keeps its documents.
+
+---
+
+## Command line
+
+The bare command (or `motion-studio serve`) starts the editor server. Two
+headless subcommands run the same plugins from a terminal, no browser:
+
+```bash
+motion-studio serve --smpl-dir ~/smpl/models        # start the editor (default)
+
+# Run the auto-corrector on a .motion and write the corrected bundle:
+motion-studio correct in.motion -o out.motion
+motion-studio correct in.motion -o out.motion --corrector ./my.py:MyCorrector
+
+# Compute metrics on a .motion and print them:
+motion-studio metrics in.motion
+motion-studio metrics in.motion --metrics ./my.py:MyMetrics
+
+motion-studio --version
+```
+
+`--corrector` / `--metrics` take a plugin spec (`<module-or-path>:<Class>`),
+the same as the server flags; omit them to use the built-in plugins.
+
+---
+
+## Docker
+
+A `Dockerfile` is included. Build the image, then run it with your SMPL models
+mounted in and the port published:
+
+```bash
+docker build -t motion-studio .
+docker run -p 8815:8815 -v ~/smpl/models:/models -e SMPL_DIR=/models motion-studio
+```
+
+Then open <http://127.0.0.1:8815>. Mount a host folder to `/workspace` (and set
+`MOTION_STUDIO_HOME=/workspace`) to persist your `.motion` bundles across runs.
+
+---
+
+## Python API
+
+Motion Studio is also a library — import it and use the data model, bundle I/O
+and plugin loaders directly, headless:
+
+```python
+import motion_studio as ms
+
+bundle = ms.load_bundle("session.motion")     # -> Bundle (original/edited + media)
+motion = bundle.original                       # -> Motion(poses, trans, betas, …)
+
+corrector = ms.load_corrector(
+    "motion_studio.plugins_builtin.corrector:Corrector",
+    smpl_dir="~/smpl/models",
+)
+fixed = corrector.correct(motion)
+
+ms.save_bundle("fixed.motion", original=motion, edited=fixed)
+```
+
+The top-level surface (`__all__`) is: `Motion`, `Floor`, `load_bundle`,
+`save_bundle`, `load_corrector`, `load_metrics`, `scan_dataset`, `Config`,
+`__version__`. The library core imports with only numpy + flask (no torch).
+
+---
+
+## The `.motion` save file
+
+A `.motion` file is a single ZIP archive bundling an entire editing session:
+
+```
+manifest.json        format/version, comments, video placement params,
+                     metrics snapshot, timestamps
+motion_original.npz  the original SMPL motion (poses, trans, betas, fps, gender)
+motion_edited.npz    your edited motion (omitted if you have not edited)
+video.mp4            the source video (optional)
+music.<ext>          the music track (optional)
+```
+
+Open a `.motion` to **continue** where you left off; the SMPL `.pkl` is written
+out only when you click **Export**.
+
+---
+
+## Plugins: bring your own correction / metrics
+
+Motion Studio depends only on a small contract, not on any concrete
+implementation. A plugin is any class matching one of these protocols
+(`motion_studio/core/plugins.py`):
+
+```python
+class MotionCorrector(Protocol):
+    def __init__(self, *, smpl_dir, floor=None): ...
+    def correct(self, motion: Motion, log=print) -> Motion: ...
+
+class MotionMetrics(Protocol):
+    def __init__(self, *, smpl_dir): ...
+    def compute(self, motion: Motion, floor: Floor) -> dict[str, float]: ...
+```
+
+`Motion` and `Floor` are the only types exchanged
+(`motion_studio/core/types.py`):
+
+```python
+@dataclass
+class Motion:
+    poses: np.ndarray   # (N, T, 24, 3) axis-angle, z-up
+    trans: np.ndarray   # (N, T, 3)
+    betas: np.ndarray | None
+    gender: str
+    fps: float
+    name: str
+
+@dataclass
+class Floor:
+    plane: tuple[float, float, float]   # z = a*x + b*y + c
+```
+
+Point the tool at your own classes (a dotted module **or** a file path,
+followed by the class name); they are re-imported on every run, so edits take
+effect on the next click:
+
+```bash
+motion-studio --corrector ./my_corrector.py:MyCorrector \
+              --metrics   ./my_metrics.py:MyMetrics
+```
+
+The built-in plugins live in `motion_studio/plugins_builtin/`.
+
+**New to plugins?** See the full authoring guide in
+[`docs/PLUGINS.md`](docs/PLUGINS.md) and the runnable, dependency-light
+examples in [`examples/`](examples). For instance, the pure-numpy metrics
+example (no torch / no SMPL needed) shows custom keys rendering end to end:
+
+```bash
+motion-studio --metrics ./examples/simple_metrics.py:SimpleMetrics
+```
+
+---
+
+## Documentation
+
+- [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) — module map, data model,
+  request flow, the heavy-lock model, the `.motion` format.
+- [`docs/PLUGINS.md`](docs/PLUGINS.md) — the plugin authoring guide.
+- [`docs/USAGE.md`](docs/USAGE.md) — day-to-day editor usage.
+- [`docs/API.md`](docs/API.md) — the HTTP API.
+- [`CONTRIBUTING.md`](CONTRIBUTING.md) — dev install, tests, lint/format.
+- [`SECURITY.md`](SECURITY.md) — the threat model and `--allow-remote` risk.
+
+---
+
+## License
+
+Released under the **MIT License** (see the `LICENSE` file in the repository).

motion_studio-0.1.0/README.md

@@ -0,0 +1,251 @@
+# Motion Studio
+
+[![PyPI version](https://img.shields.io/pypi/v/motion-studio.svg)](https://pypi.org/project/motion-studio/)
+[![Python versions](https://img.shields.io/pypi/pyversions/motion-studio.svg)](https://pypi.org/project/motion-studio/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![CI](https://github.com/melissa-colin/motion-studio/actions/workflows/ci.yml/badge.svg)](https://github.com/melissa-colin/motion-studio/actions/workflows/ci.yml)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-261230.svg)](https://github.com/astral-sh/ruff)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+A clean, installable **multi-person SMPL motion editor** for the browser, with
+a 3D view (Three.js), a video/music background, frame-by-frame pose editing,
+and **pluggable** auto-correction and metrics.
+
+It started as an internal pose editor for the AIOZ-GDANCE dataset and was
+rewritten as a small, modular, self-contained tool: no dependency on any
+external research repo, a single save-file format, and a plugin contract so you
+can drop in **your own** correction / metrics classes without touching the app.
+
+![Motion Studio — playing a clip over its source video while orbiting the camera](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/demo.gif)
+
+*Editing a multi-person clip: the SMPL motion and the source video play in sync while you orbit the camera.*
+
+---
+
+## Features
+
+- **3D editor**: skeleton + SMPL mesh, per-joint and whole-body editing, undo/redo.
+- **Video & music background**: place the source video in the scene (position,
+  scale, opacity, time offset), server-side background removal, audio playback
+  synced to the timeline.
+- **Floor**: estimate / edit / recompute the ground plane.
+- **Auto-correction & metrics**: run a correction pipeline and score the motion;
+  both are **plugins** (built-in by default, swappable for your own).
+- **One save file**: a `.motion` bundle holds the original motion, your edits,
+  the video, the music, placement parameters, comments and a metrics snapshot.
+- **Two ways to load**: open a single SMPL `.pkl` (with optional video/music),
+  or point at a whole `GDance/` folder and convert it into the workspace.
+
+---
+
+## Screenshots
+
+![The 3D editor](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/editor.png)
+*The 3D editor: multiple SMPL dancers (mesh + skeleton), per-joint and
+whole-body editing, the automatic corrector (a plugin), and the live metrics
+panel. One **Save (.motion)** button and an **Export (.pkl)** button.*
+
+![Video background](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/video.png)
+*The source video as a placeable background — position, scale, opacity, time
+offset and server-side background removal — to check the motion against the
+real footage.*
+
+![Estimated floor](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/floor.png)
+*The ground plane is estimated on load (RANSAC on foot contacts) and can be
+edited or recomputed.*
+
+![Empty start](https://raw.githubusercontent.com/melissa-colin/motion-studio/main/docs/img/empty.png)
+*On startup the editor is empty (no clip auto-loaded, no pop-up). From the
+**Clip** tab you choose: browse loaded clips, open a folder, or import a .pkl.*
+
+---
+
+## Install
+
+```bash
+pip install "motion-studio[all]"   # recommended: full feature set
+```
+
+`[all]` pulls in torch, smplx, torchvision, pillow, librosa and scipy — the SMPL
+forward kinematics, pose refit, built-in corrector/metrics, server-side
+background removal and music import. Narrower extras are available:
+
+```bash
+pip install motion-studio            # core only (numpy + flask): no SMPL/video
+pip install "motion-studio[smpl]"    # + torch, smplx
+pip install "motion-studio[video]"   # + pillow, torchvision, librosa, scipy
+pip install "motion-studio[dev]"     # + pytest, ruff, black, pre-commit
+```
+
+Requires Python >= 3.9. The SMPL body models are **not** shipped; point the tool
+at your local copy with `--smpl-dir`.
+
+## Run
+
+```bash
+motion-studio --workspace ~/MotionStudio --smpl-dir ~/smpl/models --port 8815
+# optional: import a raw dataset folder
+motion-studio --data /path/to/GDance --smpl-dir ~/smpl/models
+```
+
+Then open <http://127.0.0.1:8815>.
+
+The **workspace** is the root folder that holds your saved `.motion` bundles,
+like any desktop app keeps its documents.
+
+---
+
+## Command line
+
+The bare command (or `motion-studio serve`) starts the editor server. Two
+headless subcommands run the same plugins from a terminal, no browser:
+
+```bash
+motion-studio serve --smpl-dir ~/smpl/models        # start the editor (default)
+
+# Run the auto-corrector on a .motion and write the corrected bundle:
+motion-studio correct in.motion -o out.motion
+motion-studio correct in.motion -o out.motion --corrector ./my.py:MyCorrector
+
+# Compute metrics on a .motion and print them:
+motion-studio metrics in.motion
+motion-studio metrics in.motion --metrics ./my.py:MyMetrics
+
+motion-studio --version
+```
+
+`--corrector` / `--metrics` take a plugin spec (`<module-or-path>:<Class>`),
+the same as the server flags; omit them to use the built-in plugins.
+
+---
+
+## Docker
+
+A `Dockerfile` is included. Build the image, then run it with your SMPL models
+mounted in and the port published:
+
+```bash
+docker build -t motion-studio .
+docker run -p 8815:8815 -v ~/smpl/models:/models -e SMPL_DIR=/models motion-studio
+```
+
+Then open <http://127.0.0.1:8815>. Mount a host folder to `/workspace` (and set
+`MOTION_STUDIO_HOME=/workspace`) to persist your `.motion` bundles across runs.
+
+---
+
+## Python API
+
+Motion Studio is also a library — import it and use the data model, bundle I/O
+and plugin loaders directly, headless:
+
+```python
+import motion_studio as ms
+
+bundle = ms.load_bundle("session.motion")     # -> Bundle (original/edited + media)
+motion = bundle.original                       # -> Motion(poses, trans, betas, …)
+
+corrector = ms.load_corrector(
+    "motion_studio.plugins_builtin.corrector:Corrector",
+    smpl_dir="~/smpl/models",
+)
+fixed = corrector.correct(motion)
+
+ms.save_bundle("fixed.motion", original=motion, edited=fixed)
+```
+
+The top-level surface (`__all__`) is: `Motion`, `Floor`, `load_bundle`,
+`save_bundle`, `load_corrector`, `load_metrics`, `scan_dataset`, `Config`,
+`__version__`. The library core imports with only numpy + flask (no torch).
+
+---
+
+## The `.motion` save file
+
+A `.motion` file is a single ZIP archive bundling an entire editing session:
+
+```
+manifest.json        format/version, comments, video placement params,
+                     metrics snapshot, timestamps
+motion_original.npz  the original SMPL motion (poses, trans, betas, fps, gender)
+motion_edited.npz    your edited motion (omitted if you have not edited)
+video.mp4            the source video (optional)
+music.<ext>          the music track (optional)
+```
+
+Open a `.motion` to **continue** where you left off; the SMPL `.pkl` is written
+out only when you click **Export**.
+
+---
+
+## Plugins: bring your own correction / metrics
+
+Motion Studio depends only on a small contract, not on any concrete
+implementation. A plugin is any class matching one of these protocols
+(`motion_studio/core/plugins.py`):
+
+```python
+class MotionCorrector(Protocol):
+    def __init__(self, *, smpl_dir, floor=None): ...
+    def correct(self, motion: Motion, log=print) -> Motion: ...
+
+class MotionMetrics(Protocol):
+    def __init__(self, *, smpl_dir): ...
+    def compute(self, motion: Motion, floor: Floor) -> dict[str, float]: ...
+```
+
+`Motion` and `Floor` are the only types exchanged
+(`motion_studio/core/types.py`):
+
+```python
+@dataclass
+class Motion:
+    poses: np.ndarray   # (N, T, 24, 3) axis-angle, z-up
+    trans: np.ndarray   # (N, T, 3)
+    betas: np.ndarray | None
+    gender: str
+    fps: float
+    name: str
+
+@dataclass
+class Floor:
+    plane: tuple[float, float, float]   # z = a*x + b*y + c
+```
+
+Point the tool at your own classes (a dotted module **or** a file path,
+followed by the class name); they are re-imported on every run, so edits take
+effect on the next click:
+
+```bash
+motion-studio --corrector ./my_corrector.py:MyCorrector \
+              --metrics   ./my_metrics.py:MyMetrics
+```
+
+The built-in plugins live in `motion_studio/plugins_builtin/`.
+
+**New to plugins?** See the full authoring guide in
+[`docs/PLUGINS.md`](docs/PLUGINS.md) and the runnable, dependency-light
+examples in [`examples/`](examples). For instance, the pure-numpy metrics
+example (no torch / no SMPL needed) shows custom keys rendering end to end:
+
+```bash
+motion-studio --metrics ./examples/simple_metrics.py:SimpleMetrics
+```
+
+---
+
+## Documentation
+
+- [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) — module map, data model,
+  request flow, the heavy-lock model, the `.motion` format.
+- [`docs/PLUGINS.md`](docs/PLUGINS.md) — the plugin authoring guide.
+- [`docs/USAGE.md`](docs/USAGE.md) — day-to-day editor usage.
+- [`docs/API.md`](docs/API.md) — the HTTP API.
+- [`CONTRIBUTING.md`](CONTRIBUTING.md) — dev install, tests, lint/format.
+- [`SECURITY.md`](SECURITY.md) — the threat model and `--allow-remote` risk.
+
+---
+
+## License
+
+Released under the **MIT License** (see the `LICENSE` file in the repository).

motion_studio-0.1.0/motion_studio/__init__.py

@@ -0,0 +1,52 @@
+"""Motion Studio: a clean, installable multi-person SMPL motion editor.
+
+The names re-exported here are the package's stable public API. Everything in
+this top-level namespace is torch-free and safe to import in a numpy+flask-only
+("core") install: the heavy server stack and the built-in torch/SMPL plugins
+are imported lazily, never at package import time.
+
+Typical use::
+
+    import motion_studio as ms
+
+    bundle = ms.load_bundle("session.motion")
+    motion = bundle.original                       # ms.Motion
+    corrector = ms.load_corrector(ms.Config().corrector_spec,
+                                  smpl_dir="~/smpl/models")
+    fixed = corrector.correct(motion)
+    ms.save_motion_pkl(fixed, "fixed.pkl")
+"""
+from __future__ import annotations
+
+from .bundle import load_bundle, save_bundle
+from .config import Config
+from .core.plugins import (MotionCorrector, MotionMetrics, load_corrector,
+                           load_metrics)
+from .core.types import Floor, Motion
+from .library import import_dataset, scan_dataset
+from .smpl.io import load_motion_pkl, save_motion_pkl
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # Core data types.
+    "Motion",
+    "Floor",
+    # Plugin contracts + loaders.
+    "MotionCorrector",
+    "MotionMetrics",
+    "load_corrector",
+    "load_metrics",
+    # SMPL pkl I/O.
+    "load_motion_pkl",
+    "save_motion_pkl",
+    # .motion bundle I/O.
+    "save_bundle",
+    "load_bundle",
+    # Dataset discovery / import.
+    "scan_dataset",
+    "import_dataset",
+    # Configuration.
+    "Config",
+    "__version__",
+]

motion_studio-0.1.0/motion_studio/__main__.py

@@ -0,0 +1,8 @@
+"""Allow ``python -m motion_studio`` to start the server."""
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())