ohao 0.1.0__tar.gz

ohao-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OhaoTech
+
+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.

ohao-0.1.0/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: ohao
+Version: 0.1.0
+Summary: Retarget animations onto any humanoid character — CLI & Python SDK for game developers
+Author: OhaoTech
+License-Expression: MIT
+Project-URL: Homepage, https://mogen3d.ohao.tech
+Project-URL: Documentation, https://github.com/OhaoTech/ohao-sdk#readme
+Project-URL: Repository, https://github.com/OhaoTech/ohao-sdk
+Project-URL: Issues, https://github.com/OhaoTech/ohao-sdk/issues
+Keywords: motion-capture,mocap,bvh,fbx,retarget,blender,game-dev,animation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-httpx; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/OhaoTech/ohao-sdk/master/logo.png" alt="ohao" width="80" />
+</p>
+
+<h1 align="center">ohao</h1>
+
+<p align="center">
+  <strong>Retarget animations onto any humanoid character</strong><br>
+  CLI & Python SDK for game developers
+</p>
+
+<p align="center">
+  <a href="https://github.com/OhaoTech/ohao-sdk/actions"><img src="https://img.shields.io/github/actions/workflow/status/OhaoTech/ohao-sdk/test.yml?style=flat-square" alt="CI"></a>
+  <a href="https://pypi.org/project/ohao/"><img src="https://img.shields.io/pypi/v/ohao?style=flat-square&color=blue" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ohao/"><img src="https://img.shields.io/pypi/pyversions/ohao?style=flat-square" alt="Python"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/OhaoTech/ohao-sdk?style=flat-square" alt="License"></a>
+</p>
+
+---
+
+**ohao** retargets BVH / FBX animations onto your characters — Mixamo, UE5 Mannequin, or any humanoid rig.
+
+## Install
+
+```bash
+pip install ohao
+```
+
+> Retargeting requires [Blender](https://www.blender.org/download/) (3.6+) installed locally.
+
+## Quick Start
+
+### Python
+
+```python
+from ohao.mogen3d import retarget
+
+retarget("dance.bvh", "MyCharacter.fbx")
+```
+
+### CLI
+
+```bash
+ohao mogen3d retarget dance.bvh MyCharacter.fbx --preset mixamo
+```
+
+## Retargeting
+
+The SDK auto-detects your character's rig type and maps bones automatically.
+
+| Rig Type | Detection | Characters |
+|----------|-----------|------------|
+| **Mixamo** | `Hips` bone (with optional prefix like `mixamorig:`) | X Bot, Y Bot, any Mixamo character |
+| **UE5 Mannequin** | `pelvis` bone | Quinn, Manny, Quaternius models |
+
+```python
+# Auto-detect (works for most characters)
+retarget("dance.bvh", "XBot.fbx")
+
+# Explicit preset
+retarget("dance.bvh", "Quinn.gltf", preset="ue5")
+
+# Custom Blender path
+retarget("dance.bvh", "MyChar.fbx", blender_path="/path/to/blender")
+
+# Open in Blender GUI to inspect
+retarget("dance.bvh", "MyChar.fbx", background=False)
+```
+
+### Supported Formats
+
+| Input | Output |
+|-------|--------|
+| Animation: `.bvh`, `.fbx` | Retargeted `.blend` file |
+| Character: `.fbx`, `.glb`, `.gltf` | |
+
+## API Reference
+
+### `retarget()`
+
+```python
+retarget(
+    bvh_path,            # Path to BVH file
+    character_path,      # Path to character (.fbx / .glb / .gltf)
+    *,
+    output_path=None,    # Output .blend path (default: auto-named)
+    preset=None,         # "mixamo", "ue5", or path to JSON
+    blender_path=None,   # Blender executable (default: auto-detect)
+    background=True,     # Run headless (default: True)
+)
+```
+
+## Examples
+
+See the [`examples/`](examples/) directory for runnable scripts:
+
+| Example | Description |
+|---------|-------------|
+| [`basic_retarget.py`](examples/basic_retarget.py) | Minimal one-liner retarget |
+| [`batch_retarget.py`](examples/batch_retarget.py) | Apply one BVH to a folder of characters |
+| [`retarget_with_preset.py`](examples/retarget_with_preset.py) | Force a specific rig preset |
+| [`inspect_in_blender.py`](examples/inspect_in_blender.py) | Open result in Blender GUI |
+| [`custom_blender_path.py`](examples/custom_blender_path.py) | Use a specific Blender install |
+
+## Adding a Custom Rig Preset
+
+If your character uses a non-standard skeleton, create a JSON preset:
+
+```json
+{
+  "name": "My Rig",
+  "bone_map": {
+    "Hips": "my_pelvis",
+    "Spine": "my_spine_01",
+    "Head": "my_head",
+    "LeftArm": "my_upper_arm_L",
+    "LeftForeArm": "my_lower_arm_L",
+    "RightArm": "my_upper_arm_R",
+    "RightForeArm": "my_lower_arm_R",
+    "LeftUpLeg": "my_thigh_L",
+    "LeftLeg": "my_shin_L",
+    "RightUpLeg": "my_thigh_R",
+    "RightLeg": "my_shin_R"
+  },
+  "root_bone": "Hips"
+}
+```
+
+Keys on the left are the BVH bone names. Values on the right are your character's bone names. Then pass it:
+
+```python
+retarget("dance.bvh", "MyRig.fbx", preset="my_rig.json")
+```
+
+```bash
+ohao mogen3d retarget dance.bvh MyRig.fbx --preset my_rig.json
+```
+
+## License
+
+MIT

ohao-0.1.0/README.md

@@ -0,0 +1,141 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/OhaoTech/ohao-sdk/master/logo.png" alt="ohao" width="80" />
+</p>
+
+<h1 align="center">ohao</h1>
+
+<p align="center">
+  <strong>Retarget animations onto any humanoid character</strong><br>
+  CLI & Python SDK for game developers
+</p>
+
+<p align="center">
+  <a href="https://github.com/OhaoTech/ohao-sdk/actions"><img src="https://img.shields.io/github/actions/workflow/status/OhaoTech/ohao-sdk/test.yml?style=flat-square" alt="CI"></a>
+  <a href="https://pypi.org/project/ohao/"><img src="https://img.shields.io/pypi/v/ohao?style=flat-square&color=blue" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ohao/"><img src="https://img.shields.io/pypi/pyversions/ohao?style=flat-square" alt="Python"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/OhaoTech/ohao-sdk?style=flat-square" alt="License"></a>
+</p>
+
+---
+
+**ohao** retargets BVH / FBX animations onto your characters — Mixamo, UE5 Mannequin, or any humanoid rig.
+
+## Install
+
+```bash
+pip install ohao
+```
+
+> Retargeting requires [Blender](https://www.blender.org/download/) (3.6+) installed locally.
+
+## Quick Start
+
+### Python
+
+```python
+from ohao.mogen3d import retarget
+
+retarget("dance.bvh", "MyCharacter.fbx")
+```
+
+### CLI
+
+```bash
+ohao mogen3d retarget dance.bvh MyCharacter.fbx --preset mixamo
+```
+
+## Retargeting
+
+The SDK auto-detects your character's rig type and maps bones automatically.
+
+| Rig Type | Detection | Characters |
+|----------|-----------|------------|
+| **Mixamo** | `Hips` bone (with optional prefix like `mixamorig:`) | X Bot, Y Bot, any Mixamo character |
+| **UE5 Mannequin** | `pelvis` bone | Quinn, Manny, Quaternius models |
+
+```python
+# Auto-detect (works for most characters)
+retarget("dance.bvh", "XBot.fbx")
+
+# Explicit preset
+retarget("dance.bvh", "Quinn.gltf", preset="ue5")
+
+# Custom Blender path
+retarget("dance.bvh", "MyChar.fbx", blender_path="/path/to/blender")
+
+# Open in Blender GUI to inspect
+retarget("dance.bvh", "MyChar.fbx", background=False)
+```
+
+### Supported Formats
+
+| Input | Output |
+|-------|--------|
+| Animation: `.bvh`, `.fbx` | Retargeted `.blend` file |
+| Character: `.fbx`, `.glb`, `.gltf` | |
+
+## API Reference
+
+### `retarget()`
+
+```python
+retarget(
+    bvh_path,            # Path to BVH file
+    character_path,      # Path to character (.fbx / .glb / .gltf)
+    *,
+    output_path=None,    # Output .blend path (default: auto-named)
+    preset=None,         # "mixamo", "ue5", or path to JSON
+    blender_path=None,   # Blender executable (default: auto-detect)
+    background=True,     # Run headless (default: True)
+)
+```
+
+## Examples
+
+See the [`examples/`](examples/) directory for runnable scripts:
+
+| Example | Description |
+|---------|-------------|
+| [`basic_retarget.py`](examples/basic_retarget.py) | Minimal one-liner retarget |
+| [`batch_retarget.py`](examples/batch_retarget.py) | Apply one BVH to a folder of characters |
+| [`retarget_with_preset.py`](examples/retarget_with_preset.py) | Force a specific rig preset |
+| [`inspect_in_blender.py`](examples/inspect_in_blender.py) | Open result in Blender GUI |
+| [`custom_blender_path.py`](examples/custom_blender_path.py) | Use a specific Blender install |
+
+## Adding a Custom Rig Preset
+
+If your character uses a non-standard skeleton, create a JSON preset:
+
+```json
+{
+  "name": "My Rig",
+  "bone_map": {
+    "Hips": "my_pelvis",
+    "Spine": "my_spine_01",
+    "Head": "my_head",
+    "LeftArm": "my_upper_arm_L",
+    "LeftForeArm": "my_lower_arm_L",
+    "RightArm": "my_upper_arm_R",
+    "RightForeArm": "my_lower_arm_R",
+    "LeftUpLeg": "my_thigh_L",
+    "LeftLeg": "my_shin_L",
+    "RightUpLeg": "my_thigh_R",
+    "RightLeg": "my_shin_R"
+  },
+  "root_bone": "Hips"
+}
+```
+
+Keys on the left are the BVH bone names. Values on the right are your character's bone names. Then pass it:
+
+```python
+retarget("dance.bvh", "MyRig.fbx", preset="my_rig.json")
+```
+
+```bash
+ohao mogen3d retarget dance.bvh MyRig.fbx --preset my_rig.json
+```
+
+## License
+
+MIT

ohao-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ohao"
+version = "0.1.0"
+description = "Retarget animations onto any humanoid character — CLI & Python SDK for game developers"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "OhaoTech" }]
+keywords = ["motion-capture", "mocap", "bvh", "fbx", "retarget", "blender", "game-dev", "animation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Graphics :: 3D Modeling",
+    "Topic :: Games/Entertainment",
+]
+dependencies = [
+    "httpx>=0.24.0",
+    "click>=8.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "pytest-httpx", "ruff"]
+
+[project.scripts]
+ohao = "ohao._cli:main"
+
+[project.urls]
+Homepage = "https://mogen3d.ohao.tech"
+Documentation = "https://github.com/OhaoTech/ohao-sdk#readme"
+Repository = "https://github.com/OhaoTech/ohao-sdk"
+Issues = "https://github.com/OhaoTech/ohao-sdk/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"ohao.mogen3d.presets" = ["*.json"]
+"ohao.mogen3d" = ["_blender_script.py"]

ohao-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ohao-0.1.0/src/ohao/__init__.py

@@ -0,0 +1,3 @@
+"""ohao — CLI & SDK for game developers."""
+
+__version__ = "0.1.0"

ohao-0.1.0/src/ohao/_cli.py

@@ -0,0 +1,68 @@
+"""ohao CLI — entry point for all ohao tools."""
+
+import click
+
+
+@click.group()
+@click.version_option(package_name="ohao")
+def main():
+    """ohao — CLI & SDK for game developers."""
+
+
+@main.group()
+def mogen3d():
+    """Motion capture: video -> BVH/FBX."""
+
+
+@mogen3d.command()
+@click.argument("video_path", type=click.Path(exists=True))
+@click.option("--api-key", envvar="OHAO_API_KEY", required=True, help="MoGen3D API key (or set OHAO_API_KEY).")
+@click.option("--pipeline", type=click.Choice(["2d", "3d"]), default="2d", help="Processing pipeline.")
+@click.option("--fps", type=int, default=30, help="Output FPS.")
+@click.option("--format", "fmt", type=click.Choice(["bvh", "fbx", "json"]), default="bvh", help="Download format.")
+@click.option("--output", "-o", type=click.Path(), default=None, help="Output file path.")
+@click.option("--base-url", envvar="OHAO_BASE_URL", default=None, help="API base URL override.")
+def process(video_path, api_key, pipeline, fps, fmt, output, base_url):
+    """Upload a video, process it, and download the result."""
+    from ohao.mogen3d.client import MoGen3DClient
+
+    kwargs = {"api_key": api_key}
+    if base_url:
+        kwargs["base_url"] = base_url
+
+    with MoGen3DClient(**kwargs) as client:
+        click.echo(f"Uploading {video_path}...")
+        job = client.upload(video_path, pipeline=pipeline, fps=fps)
+        click.echo(f"Job {job.id} created. Waiting for completion...")
+
+        job = job.wait()
+        if job.status == "failed":
+            click.echo(f"Job failed: {job.error}", err=True)
+            raise SystemExit(1)
+
+        click.echo(f"Done! {job.frames} frames extracted.")
+        path = job.download(format=fmt, output_path=output)
+        click.echo(f"Saved to {path}")
+
+
+@mogen3d.command()
+@click.argument("bvh_path", type=click.Path(exists=True))
+@click.argument("character_path", type=click.Path(exists=True))
+@click.option("--output", "-o", type=click.Path(), default=None, help="Output .blend file path.")
+@click.option("--preset", type=str, default=None, help="Rig preset: 'mixamo', 'ue5', or path to JSON.")
+@click.option("--blender", type=click.Path(), default=None, help="Path to Blender executable.")
+@click.option("--gui", is_flag=True, help="Open Blender with GUI (default: background mode).")
+def retarget(bvh_path, character_path, output, preset, blender, gui):
+    """Retarget a BVH animation onto a character model using Blender."""
+    from ohao.mogen3d.retarget import retarget as do_retarget
+
+    click.echo(f"Retargeting {bvh_path} -> {character_path}...")
+    path = do_retarget(
+        bvh_path,
+        character_path,
+        output_path=output,
+        preset=preset,
+        blender_path=blender,
+        background=not gui,
+    )
+    click.echo(f"Saved to {path}")

ohao-0.1.0/src/ohao/_exceptions.py

@@ -0,0 +1,22 @@
+"""Shared exception hierarchy."""
+
+
+class OhaoError(Exception):
+    """Base exception for ohao SDK."""
+
+
+class MoGenError(OhaoError):
+    """Raised when the MoGen3D API returns an error."""
+
+    def __init__(self, status_code: int, detail: str):
+        self.status_code = status_code
+        self.detail = detail
+        super().__init__(f"HTTP {status_code}: {detail}")
+
+
+class RetargetError(OhaoError):
+    """Raised when Blender retargeting fails."""
+
+
+class BlenderNotFoundError(RetargetError):
+    """Raised when Blender executable cannot be found."""

ohao-0.1.0/src/ohao/mogen3d/__init__.py

@@ -0,0 +1,6 @@
+"""ohao.mogen3d — motion capture SDK."""
+
+from ohao.mogen3d.client import MoGen3DClient
+from ohao.mogen3d.retarget import retarget
+
+__all__ = ["MoGen3DClient", "retarget"]