README.md

---
license: apache-2.0
pipeline_tag: text-to-speech
library_name: dots_tts
tags:
  - text-to-speech
  - tts
  - audio
  - speech-synthesis
  - voice-cloning
  - autoregressive
  - meanflow
  - two-step
---

# dots.tts-mf-2steps

<p align="left">
  <a href="https://github.com/studio-dots-ai/dots.tts"><img src="https://img.shields.io/badge/GitHub-studio--dots--ai%2Fdots.tts-blue?logo=github" alt="GitHub"></a>
  <a href="https://huggingface.co/spaces/dots-studio/dots.tts"><img src="https://img.shields.io/badge/Playground-Live-orange" alt="Playground"></a>
  <a href="https://studio-dots-ai.github.io/dots.tts-demo/"><img src="https://img.shields.io/badge/Demo%20Page-Live-red" alt="Demo Page"></a>
</p>

This repository provides a standalone dots.tts artifact for **fixed two-step inference**.
The sampling contract is stored in `config.json` and selected automatically.
Sampling options should be omitted.

## Quick start

```bash
dots.tts \
  --model-name-or-path dots-studio/dots.tts-mf-2steps \
  --text "Hello, this is a two-step MeanFlow voice cloning example." \
  --prompt-audio /path/to/reference.wav \
  --prompt-text "The exact transcript spoken in the reference audio." \
  --output cloned.wav
```

```python
from dots_tts.runtime import DotsTtsRuntime

runtime = DotsTtsRuntime.from_pretrained(
    "dots-studio/dots.tts-mf-2steps",
    precision="bfloat16",
)
result = runtime.generate(
    text="Hello, this is a two-step MeanFlow voice cloning example.",
    prompt_audio_path="/path/to/reference.wav",
    prompt_text="The exact transcript spoken in the reference audio.",
)
```

Passing incompatible sampling values raises an error.

## Scope and limitations

This model is intended for fixed two-step inference. Other sampling settings are not claimed.
High-fidelity voice cloning must be used only with authorization and consent; do not use it
for impersonation, fraud, or disinformation.

---

## Citation

```bibtex
@article{dotstts2026,
  title         = {dots.tts Technical Report},
  author        = {dots.tts Team},
  year          = {2026},
  eprint        = {2606.07080},
  archivePrefix = {arXiv},
  primaryClass  = {cs.SD},
}
```

## License

Released under [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0).