Instructions to use moiralabs/MoiraTTSNano with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use moiralabs/MoiraTTSNano with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-to-speech", model="moiralabs/MoiraTTSNano")# pip install -U transformers accelerate # Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("moiralabs/MoiraTTSNano") model = AutoModelForCausalLM.from_pretrained("moiralabs/MoiraTTSNano", device_map="auto") - Notebooks
- Google Colab
- Kaggle
Configuration Parsing Warning:Config file tokenizer_config.json cannot be fetched (too big)
MoiraTTSNano (female voice)
👩💻 Chat with Moira locally on your phone https://play.google.com/store/apps/details?id=com.moiraai.voice
Female-voice Greek fine-tune of NeuTTS-Nano for the MoiraAI voice stack: a compact single-voice speech language model that turns text into NeuCodec audio tokens in Moira's voice. It is fine-tuned to produce this one specific voice — not to clone arbitrary voices.
The Nano line trades some quality for size and speed — same open NeuTTS LM + codec design as Air, in a ~120M-active-parameter backbone that runs comfortably on phones and low-end CPUs.
Samples
Reference transcript (samples/greek.txt): "Ο βροντόσαυρος έψαχνε τροφή στην αυλή."
| clip | audio |
|---|---|
| Reference voice | |
| Generated example |
Model details
- Voice: female, single voice — Moira. Fine-tuned to speak as Moira; always generate with a reference clip of Moira's voice.
- Backbone: Llama causal LM — 24 layers, hidden size 576, 9 attention heads / 3 KV heads, Llama-3-style tokenizer.
- Vocabulary: 194,256 tokens — base BPE plus added audio/speech
tokens (
<|SPEECH_GENERATION_END|>etc.). - Codec: neuphonic/neucodec (50 Hz, single codebook) — this repo holds the LM half only.
- Input: phonemised text (handled automatically by the
neuttspackage viaespeak-ng). - Operating window: 2048 tokens ≈ ~30 s of audio including the voice prompt.
- Training: fine-tuned for 1 epoch (21,439 steps) — loss curve in
trainer_state.json. - Base project: neuphonic/neutts (NeuTTS-Nano multilingual collection).
- License: this model follows the upstream NeuTTS terms —
NeuTTS Open License v1.0
(tagged
other, not Apache-2.0).
Usage
Requires espeak-ng on your system
(install guide).
This is a public repo — no login needed. Note: the neuphonic/neucodec
codec repo is auto-gated, so accept access once while logged in; the
backbone itself needs nothing.
pip install neutts soundfile
from neutts import NeuTTS
import soundfile as sf
tts = NeuTTS(
backbone_repo="moiralabs/MoiraTTSNano",
backbone_device="cpu",
codec_repo="neuphonic/neucodec",
codec_device="cpu",
language="el", # required: non-Neuphonic backbones raise without it
)
input_text = "Γεια σου! Χαίρομαι που σε γνωρίζω."
ref_text = open("samples/greek.txt").read().strip() # transcript of Moira's ref clip
ref_codes = tts.encode_reference("samples/greek.wav") # short clip of Moira's voice
wav = tts.infer(input_text, ref_codes, ref_text)
sf.write("out.wav", wav, 24000)
For on-device/quantised inference, convert the backbone to GGUF and
pass the .gguf repo as backbone_repo with llama-cpp-python
installed (pip install "neutts[llama]") — same pattern as the
upstream neutts-nano-q4-gguf /
neutts-nano-q8-gguf releases.
Other inference paths (see examples/ in
neuphonic/neutts):
- Pre-encoded references:
encode_reference()can be run once and the codes saved withtorch.save(ref_codes, "ref.pt")to skip re-encoding on every run. - ONNX decoder: pass
codec_repo="neuphonic/neucodec-onnx-decoder"(needsonnxruntimeand a pre-encoded.ptreference) for lower-latency decoding without the codec encoder. - Streaming:
tts.infer_stream(...)yields audio chunks as they generate, but only works with GGUF backbones (needspyaudio).
Notes
CPU-only machines: plain
pip install neuttspulls CUDA torch plus gigabytes of NVIDIA deps. Skip them by installing the CPU builds first (keep their versions matched to each other):pip install torch torchaudio torchvision --index-url https://download.pytorch.org/whl/cputorchaovstorchtune: currenttorchaoremovedNF4Tensor, whichtorchtune0.6.1 still imports (No module named 'torchao.dtypes.nf4tensor'). Until upstream agrees, stub it — those names only serve quantization helpers inference never calls:# torchao/dtypes/nf4tensor.py class NF4Tensor: pass def linear_nf4(*a, **k): raise RuntimeError("nf4 shim") def to_nf4(*a, **k): raise RuntimeError("nf4 shim") def implements(*a, **k): return lambda f: f
Files
model.safetensors— backbone weights (Git LFS)config.json,generation_config.json— model configtokenizer.json,tokenizer_config.json— tokenizer (Git LFS)trainer_state.json— training provenance (loss curve)training_args.bin,optimizer.pt,scheduler.pt,rng_state.pth— training state (Git LFS)samples/greek.wav,samples/greek.txt— Moira reference clip + transcriptsamples/greek_output.wav— example output in Moira's voice
Limitations
- Tuned for short Greek utterances.
- Nano trades quality for size/speed versus the Air-scale model; expect artifacts on long or out-of-domain text.
- Audio generated through the NeuTTS pipeline carries a watermark.
Disclaimer
Genos and Moira are fictional AI personas created for the MoiraAI project's own products. Do not use these models to impersonate any real individual or to create misleading recordings, robocalls, scams, or disinformation. You are responsible for complying with all applicable laws on synthetic media and voice rights. We do not condone any misuse of these models.
Acknowledgments
Special thanks to Neuphonic — pioneers of the open text-to-speech space — for releasing NeuTTS and NeuCodec as open source. This model would not exist without their work.
- Downloads last month
- 24