monster/kimodo-mrp.ccc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Make Linux setup primary in documentation

Browse Source
This commit is contained in:
Richard Palethorpe 2026-08-23 14:55:36 +01:00
parent f204774be5
commit e55a42aaa3
3 changed files with 20 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@ -13,21 +13,31 @@ Included: checked GGUF loading, safetensors conversion, DDIM sampling, C/C++
APIs, CPU/Vulkan parity tests, and a local text-to-motion demo. Constraints,
SOMA, G1, GLB export, and quantised models are not implemented yet.
## Build and test
## Build and test on Linux
GGML is a pinned Git submodule:
Install a C++23 compiler, CMake 3.25+, Ninja, Python 3 with the Hugging Face
CLI (`pip install huggingface_hub`), and the Vulkan loader/headers for Vulkan
support. GGML is a pinned Git submodule:
```sh
git submodule update --init --recursive
nix develop path:. --command cmake --preset debug
nix develop path:. --command cmake --build --preset debug
nix develop path:. --command ctest --preset debug
scripts/download_gguf_weights.sh --output "$PWD"
cmake --preset debug
cmake --build --preset debug
ctest --preset debug
```
The standard test suite requires the local motion GGUF, text bundle, and
fixtures. It never downloads weights by itself. `release`, `asan-ubsan`, and
`fuzz` presets are also available.
Nix is optional and provides these dependencies reproducibly:
```sh
nix develop path:. --command cmake --preset debug
nix develop path:. --command cmake --build --preset debug
```
For sanitizer work:
```sh
@ -71,7 +81,7 @@ text encoder and the upstream-linked
diffusion model are separate, so users download rather than recreate them:
```sh
nix develop path:. --command scripts/download_gguf_weights.sh --output "$PWD"
scripts/download_gguf_weights.sh --output "$PWD"
```
The installer verifies each published manifest and SHA-256 hashes. Use

4
scripts/hf/Kimodo-SMPLX-RP-v1-GGML/README.md
View File

@ -15,10 +15,10 @@ This repository contains only the diffusion model; its reusable Llama-derived
text encoder is distributed separately as
[`Llama-3-Kimodo-GGML`](https://huggingface.co/LocalAI-io/Llama-3-Kimodo-GGML).
From a kimodo.cpp checkout, install both with:
From a kimodo.cpp checkout with the Hugging Face CLI installed, install both with:
```sh
nix develop path:. --command scripts/download_gguf_weights.sh --output "$PWD"
scripts/download_gguf_weights.sh --output "$PWD"
```
The model is installed at `models/kimodo-smplx-rp-v1-f32.gguf`. Use

4
scripts/hf/Llama-3-Kimodo-GGML/README.md
View File

@ -11,10 +11,10 @@ reusable LLM2Vec encoder only; download a matching Kimodo diffusion model
separately, for example
[`Kimodo-SMPLX-RP-v1-GGML`](https://huggingface.co/LocalAI-io/Kimodo-SMPLX-RP-v1-GGML).
From a kimodo.cpp checkout, install both with:
From a kimodo.cpp checkout with the Hugging Face CLI installed, install both with:
```sh
nix develop path:. --command scripts/download_gguf_weights.sh --output "$PWD"
scripts/download_gguf_weights.sh --output "$PWD"
```
The components intentionally remain split into individual layers so kimodo.cpp