kimodo-mrp.ccc/scripts/hf/Llama-3-Kimodo-SMPLX-RP-v1-GGUF/README.md
2026-08-23 08:46:52 +01:00

67 lines
2.4 KiB
Markdown

---
license: other
library_name: ggml
tags:
- gguf
- ggml
- text-to-motion
- smplx
- llama-3
---
# Llama-3-Kimodo-SMPLX-RP-v1-GGUF
Native F32 GGUF conversion of NVIDIA's Kimodo-SMPLX-RP-v1 motion model and
its LLM2Vec text encoder. It is for the `kimodo.cpp` GGML runtime; it is not a
llama.cpp language-model conversion.
`Kimodo-SMPLX-RP-v1` is restricted to non-commercial research use. Before use
or redistribution, review and comply with the upstream NVIDIA model terms and
the Meta Llama 3 Community License below. This repository does not grant rights
beyond those upstream licences.
## Install
From the kimodo.cpp checkout:
```sh
nix develop path:. --command scripts/download_gguf_weights.sh --output "$PWD"
```
This places the motion model at `models/kimodo-smplx-rp-v1-f32.gguf` and text
components under `generated/llm2vec-text-bundle/`, which are the default paths
used by the library and demo. Add `--motion-only` for embedding-only inference.
`SHA256SUMS` and `MANIFEST.json` record every published artifact and its source
revision; the installer verifies the selected files after download.
## Contents
- `models/kimodo-smplx-rp-v1-f32.gguf` — Kimodo motion diffusion model (F32)
- `generated/llm2vec-text-bundle/` — tokenizer, embeddings, final norm, and 32
F32 transformer layers for native LLM2Vec inference
The text components are split deliberately: kimodo.cpp loads a bounded number
of layers at once for GPU memory control.
## Provenance
The conversion is generated by `kimodo.cpp` from these exact upstream commits:
- NVIDIA Kimodo-SMPLX-RP-v1: `1419ba56b734c48bbafb41fefa84088ca94583b5`
- Meta Llama-3-8B-Instruct: `8afb486c1db24fe5011ec46dfbe5b5dccdb575c2`
- McGill LLM2Vec MNTP adapter: `31474e395ada192e8ed1586db6be79fb3b70c9c0`
- McGill LLM2Vec supervised adapter: `baa8ebf04a1c2500e61288e7dad65e8ae42601a7`
The two McGill adapters are MIT-licensed. The merged text encoder includes
Meta Llama 3 material. **Built with Meta Llama 3.**
## Licences and notices
- Kimodo: [NVIDIA Internal Scientific Research and Development Model License](https://huggingface.co/nvidia/Kimodo-SMPLX-RP-v1)
(non-commercial research only).
- Text base: [Meta Llama 3 Community License](https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct).
- LLM2Vec adapters: [MIT](https://huggingface.co/McGill-NLP/LLM2Vec-Meta-Llama-3-8B-Instruct-mntp).
`LICENSE-META-LLAMA-3.txt` and `NOTICE` accompany every published copy with
the required Meta licence and attribution.