README.md

---
tags:
- text-to-speech
- gguf
- ggml
- x-voice
library_name: ggml
---

# X-Voice GGUF

Self-contained GGUF bundles for the X-Voice GGML C++ runtime.

Runtime repository:

```text
https://github.com/bluryar/X-Voice.cpp
```

Upstream model source:

```text
https://huggingface.co/XRXRX/X-Voice
https://github.com/sunnyxrxrx/X-Voice
```

## Files

| file | approximate size | sha256 |
|---|---:|---|
| `x-voice-f32.gguf` | 1.6 GB | `077d8dec4d94ab4562ae31cab4c0e000a9bb63a831f9ee3a5da7c8e7587df347` |
| `x-voice-f16.gguf` | 1.1 GB | `82b8bf7604da1f64c4d98e8e6afc11b3afda57058627a01054e8fc50b44505b3` |
| `x-voice-q8_0.gguf` | 848 MB | `8cb3452ad7aa1730047572bd38f22a92f87256a7dc803124b93a955b1f8ae5a5` |
| `x-voice-q6_k.gguf` | 790 MB | `5c4eb825d890f69fc706c4e06b5dd5ddec8b4ff3311cde0fc12bfa43fbcc4cf9` |
| `x-voice-q4_k.gguf` | 729 MB | `776f05d88d7bc252298272159ab91176029f4238b7eb7902d982e83bce8746a5` |

The quantized files use a conservative X-Voice policy: large GGML `mul_mat`
matrix weights are converted, while conv, norm, bias, embedding, positional, and
small tensors remain in their source type.

## Quick Start

```bash
git clone --recursive https://github.com/bluryar/X-Voice.cpp
cd X-Voice.cpp
bash scripts/dev/build_xvoice_cuda.sh

NVIDIA_TF32_OVERRIDE=0 build-cuda/x-voice-cli \
  --model /path/to/x-voice-f32.gguf \
  --load-tensors \
  --synthesize \
  --text '发帖人（弟弟）在详细描述其五口之家的现状后，寻求处理家庭问题的建议，并提出了自己的初步计划。' \
  --text-kind plain \
  --language zh \
  --ref-wav /path/to/reference.wav \
  --preset product \
  --output-wav /tmp/xvoice.wav \
  --metadata-json /tmp/xvoice.json \
  --progress \
  -b cuda -t 8
```

## License

The C++ runtime is Apache-2.0. These model artifacts are converted from upstream
X-Voice weights; please follow the upstream model license and terms for any
redistribution or commercial use.