| --- |
| license: mit |
| library_name: pytorch |
| tags: |
| - motion-generation |
| - text-to-motion |
| - humanml3d |
| - controllable-generation |
| - kv-control |
| pipeline_tag: text-to-motion |
| --- |
| |
| # KV-Control (T-Concat v4 backbone) |
|
|
| Sparse-keyframe, multi-joint controllable text-to-motion generation. The |
| repository at [github.com/Tevior/KV-Control](https://github.com/Tevior/KV-Control) |
| contains the full training and inference code. |
|
|
| ## What is here |
|
|
| | Path | Content | Size | |
| |---|---|---| |
| | `base_t_concat_v4/model/net_best_fid.tar` | Pre-trained T-Concat v4 masked-transformer base (the paper main backbone) | 168 MB | |
| | `kv_control/model/net_best_kps.tar` | KV-Control adapter trained on the base above | 520 MB | |
| | `vqvae/net_best_fid.pth` | Part-aware VQ-VAE tokenizer (128 codes × 6 parts) | 236 MB | |
| | `vqvae/skeleton_partition.json` | Skeleton partition for the part-aware VQ | 1 KB | |
| | `stats/{mean,std}.npy` | Normalization stats matching the released VQ | 4 KB | |
| | `clip/ViT-B-32.pt` | OpenAI CLIP ViT-B/32 visual + text encoder | 336 MB | |
| | `t2m/Comp_v6_KLD005/opt.txt + meta/` | Frozen evaluation encoder config & stats | 3 KB | |
| | `t2m/text_mot_match/model/finest.tar` | Pre-trained text-motion eval encoder (Guo et al., 2022) | 235 MB | |
| | `t2m/length_estimator/model/finest.tar` | Pre-trained motion-length predictor | 1.7 MB | |
| | `aux/body_models/` | SMPL neutral mesh + face / J_regressor (SMPL license) | 234 MB | |
| | `aux/glove/` | Vocab files for the length estimator | 10 MB | |
| |
| ## How to use |
| |
| ```bash |
| git clone https://github.com/Tevior/KV-Control.git |
| cd KV-Control |
| bash scripts/download_checkpoints.sh # populates checkpoints/, aux/ → glove/, body_models/ |
| ``` |
| |
| Refer to the GitHub README for installation and quick-start commands. |
| |
| ## Licenses |
| |
| * Our weights (`base_t_concat_v4`, `kv_control`, `vqvae`, `stats`) — **MIT**. |
| * CLIP ViT-B/32 — released by OpenAI under MIT. |
| * SMPL body model under `aux/body_models/` — original SMPL license (research-only). |
| * Text-motion eval encoder / length estimator under `t2m/` — re-distributed |
| from the HumanML3D / Guo et al. 2022 release for reproducibility. |
|
|
| ## Citation |
|
|
| ```bibtex |
| @article{kvcontrol2026, |
| title = {KV-Control: Sparse-Keyframe Multi-Joint Text-to-Motion Generation}, |
| author = {... (under review) ...}, |
| year = {2026}, |
| } |
| ``` |
|
|
