---
license: mit
tags:
  - text-to-motion
  - motion-generation
  - trajectory-control
  - humanml3d
library_name: pytorch
---

# KV-Control (C-Concat substrate) — pretrained weights

Pretrained weights for **KV-Control**, a parameter-efficient attention-side key/value
injection adapter for trajectory-controlled text-to-motion generation on a frozen
PartVQ + C-Concat masked-motion (MaskGIT-style) backbone.

**Code:** https://github.com/CHDTevior/kvcontrol-c-concat

Download the whole tree into `./pretrained/` of the code repo (`bash scripts/download_weights.sh`).

## Files

| Path | Description |
|---|---|
| `partvq/vq_net_best_fid.pth` + `partvq/skeleton_partition.json` | Frozen part-aware VQ tokenizer + skeleton partition (required substrate) |
| `normalization/mean.npy`, `normalization/std.npy` | 263-dim HumanML3D feature statistics |
| `c_concat_base/net_best_fid.tar` | Frozen C-Concat masked-motion backbone |
| `kv_control/net_best_fid.tar` | KV-Control trajectory adapter (best FID) |
| `kv_control/net_best_top3.tar` | KV-Control trajectory adapter (best Top-3) |

## Results (HumanML3D test, single-joint pelvis trajectory, 5-repeat mean ± 95% CI)

| Protocol | FID | Top-3 | KPS (cm) |
|---|---|---|---|
| M2 (MaskControl-matched TTT) | 0.093 ± 0.011 | 0.795 ± 0.011 | 1.10 ± 0.01 |
| M3 (+ dynamic refinement) | 0.096 ± 0.011 | 0.793 ± 0.006 | 0.96 ± 0.01 |

## Citation

Anonymous AAAI-2027 submission under review; author information withheld.

## License

MIT (weights and code). Please also honor the licenses of HumanML3D and upstream
projects (MoMask / MaskControl / OpenAI CLIP).