One-command zero-shot voice cloning with MOSS-TTS-Nano via mlx-audio.
Project description
moss-tts-nano-cli
One-command zero-shot voice cloning with the MOSS-TTS-Nano-100M model, powered by mlx-audio.
Features
- No manual setup:
uvx moss-tts-nano-cliinstalls the environment automatically. - Lazy model download: the model is fetched from Hugging Face on first use.
- Voice cloning: pass a reference WAV and text to synthesize speech in that voice.
- Apple Silicon optimized: runs on MLX.
Requirements
- Python 3.12+
- macOS with Apple Silicon (MLX backend)
- uv (recommended)
- FFmpeg (used indirectly by audio tooling)
If your
uvis configured to use a PyPI mirror that has not synced the package yet, run with the official index:uvx --index-url https://pypi.org/simple moss-tts-nano-cli --help
Install
uv tool install moss-tts-nano-cli
Or run without installing:
uvx moss-tts-nano-cli --help
Usage
Clone a voice
moss-tts-nano-cli clone \
--ref ./my_voice.wav \
--text "Hello, this is my cloned voice speaking." \
--out output.wav
The first run downloads mlx-community/MOSS-TTS-Nano-100M and the audio tokenizer into the Hugging Face cache (~/.cache/huggingface).
Eagerly download the model
moss-tts-nano-cli download
Show info
moss-tts-nano-cli info
Development
git clone https://github.com/vra/moss-tts-nano-cli.git
cd moss-tts-nano-cli
uv sync --extra dev
uv run pytest
License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file moss_tts_nano_cli-0.1.3.tar.gz.
File metadata
- Download URL: moss_tts_nano_cli-0.1.3.tar.gz
- Upload date:
- Size: 54.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
17703585a1be779ee8b385eed736640b7c19cc99788b54f0e263b2491f77c15b
|
|
| MD5 |
cf83ef0f4b674297e6c74cb24573f54b
|
|
| BLAKE2b-256 |
855bb97211b428b80274b0815040a682bec9f798f48637391a4da939a69464a9
|
File details
Details for the file moss_tts_nano_cli-0.1.3-py3-none-any.whl.
File metadata
- Download URL: moss_tts_nano_cli-0.1.3-py3-none-any.whl
- Upload date:
- Size: 5.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c7b9f9dbb8b606cd7665fc8104434f0e06242ab1875112ecd62c1e5188ceddf0
|
|
| MD5 |
88f624a75c6a145911ee49c1b0ed27cb
|
|
| BLAKE2b-256 |
293ce1842d4f7835eed78627c195eba8a3dd0051311d557d350b51767a0ad0b6
|
