---
title: Karate Wiener
emoji: 🥋
colorFrom: green
colorTo: gray
sdk: gradio
sdk_version: 6.9.0
app_file: app.py
python_version: "3.10"
suggested_hardware: zero-a10g
pinned: true
license: apache-2.0
hf_oauth: true
short_description: Create your own karate moves with a sausage man
models:
  - nvidia/Kimodo-SMPLX-RP-v1
  - McGill-NLP/LLM2Vec-Meta-Llama-3-8B-Instruct-mntp
  - McGill-NLP/LLM2Vec-Meta-Llama-3-8B-Instruct-mntp-supervised
---


# Kimodo ZeroGPU

Viewer-first ZeroGPU Space for Kimodo text-to-motion generation.

Generated animations are saved into the configured Hugging Face Dataset store so
they survive Space rebuilds and can be reused by the kata maker. Animation IDs
are deterministic from the normalized prompt, model, seconds, denoising steps,
seed, and generation schema; regenerating with the same settings returns the
cached animation instead of spending GPU time again.

## Generation model

The Space generates on the **SMPL-X 22-joint** skeleton via `kimodo-smplx-rp`
(set `KIMODO_MODEL` to override). This matches the skeleton used by the kimodo
web/kata viewers, so generated clips can be retargeted directly onto skinned
display characters with no joint remapping.

> Note: `nvidia/Kimodo-SMPLX-RP-v1` is distributed under NVIDIA's research/R&D
> model license, which is more restrictive than the NVIDIA Open Model license
> used by the SOMA models. Review it before public/commercial use.

## Display characters

The 3D viewer can play a clip as the procedural skeleton or retarget it onto a
skinned rig (an s&box Citizen ships in `assets/`). The picker in the viewer HUD
switches between them; retargeting is rest-pose alignment driven by each clip's
`global_quats_xyzw`. Additional rigs can be added to `_CHARACTER_CATALOG` in
`app.py` as `{ id, label, mapping, glb_b64 }`.