# Official Kokoro v1.0 voice packs

This directory contains all 54 F32 voice packs from
[`hexgrad/Kokoro-82M`](https://huggingface.co/hexgrad/Kokoro-82M), converted without
quantization for [`kokoro.cpp`](https://github.com/simonfxr/kokoro.cpp). Each GGUF declares the
`kokoro-voice` architecture and contains one `voice.pack` tensor with GGML shape
`(256, 1, 510)` (source PyTorch shape `(510, 1, 256)`).

| Language | Kokoro code | `kokoro.cpp -l` | Voices |
|---|:---:|:---:|---|
| American English | `a` | `en-us` | `af_alloy`, `af_aoede`, `af_bella`, `af_heart`, `af_jessica`, `af_kore`, `af_nicole`, `af_nova`, `af_river`, `af_sarah`, `af_sky`, `am_adam`, `am_echo`, `am_eric`, `am_fenrir`, `am_liam`, `am_michael`, `am_onyx`, `am_puck`, `am_santa` |
| British English | `b` | `en-gb` | `bf_alice`, `bf_emma`, `bf_isabella`, `bf_lily`, `bm_daniel`, `bm_fable`, `bm_george`, `bm_lewis` |
| Spanish | `e` | `es` | `ef_dora`, `em_alex`, `em_santa` |
| French | `f` | `fr-fr` | `ff_siwis` |
| Hindi | `h` | `hi` | `hf_alpha`, `hf_beta`, `hm_omega`, `hm_psi` |
| Italian | `i` | `it` | `if_sara`, `im_nicola` |
| Japanese | `j` | `ja` | `jf_alpha`, `jf_gongitsune`, `jf_nezumi`, `jf_tebukuro`, `jm_kumo` |
| Brazilian Portuguese | `p` | `pt-br` | `pf_dora`, `pm_alex`, `pm_santa` |
| Mandarin Chinese | `z` | `cmn` | `zf_xiaobei`, `zf_xiaoni`, `zf_xiaoxiao`, `zf_xiaoyi`, `zm_yunjian`, `zm_yunxi`, `zm_yunxia`, `zm_yunyang` |

## Download and use a voice

```bash
hf download simonfxr/kokoro.cpp-GGUF voices/kokoro-voice-ef_dora.gguf --local-dir models

./build/kokoro-cli \
  -m models/kokoro-82m-q8_0.gguf \
  -v models/voices/kokoro-voice-ef_dora.gguf \
  -l es \
  "Hola, esta es una prueba en español."
```

Keep the voice and `-l` language consistent. The first letter of each official
voice name is Kokoro's language code; the second is `f` or `m` for the voice's
published presentation.