Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 2.2.0 instead.
Reason given by maintainers: Incompatible with the current samuel-vitorino/sopro-v2-turbo artifacts. Upgrade to sopro>=2.2.0.

Sopro V2

Sopro TTS

Blog HuggingFace ONNX Demo

Sopro (from the Portuguese word for "breath/blow") is a lightweight voice-cloning text-to-speech model family. This repo ships sopro-v2-turbo, a 120M-parameter open model that streams, runs comfortably on a laptop CPU or in the browser, and reaches SOTA-level intelligibility against much larger systems. The full story, evaluations, and audio samples are in the blog post.

Main features:

  • 120M parameters
  • English, European Portuguese, French, and German
  • Streaming with ~300 ms time-to-first-audio on a laptop CPU
  • Zero-shot voice cloning from 5-20 seconds of reference audio
  • 0.24 RTF offline / 0.21 RTF streaming on an M3 CPU, 0.07 RTF on an H100
  • Runs in the browser via an ONNX runtime

Local demo

Run the model and open the demo with one command:

uvx --from sopro soprotts serve

If Sopro is already installed:

soprotts serve

Then navigate to http://localhost:7860. The model downloads on first use and stays in the Hugging Face cache. Sopro selects CUDA or CPU automatically and defaults to CPU on macOS (pass --device mps explicitly to use MPS). Use soprotts serve --help for model, device, port, and CPU int8 options.

Browser demo

There is also a fully in-browser demo with no server involved: https://samuel-vitorino.github.io/sopro/. On mobile the model is quantized, so results can be slightly below the local demo, and devices with low memory may crash. The dependency-isolated ONNX runtime and exporter are documented in web/README.md. Both demos use the frontend in demos/web.


Installation

From PyPI

pip install -U sopro

From the repo

git clone https://github.com/samuel-vitorino/sopro
cd sopro
pip install -e .

Examples

CLI

soprotts "Sopro is a lightweight 120 million parameter text-to-speech model that streams and runs on device." --ref ref.wav --out out.wav

Add --stream for the streaming path. You have the expected --temperature, --top-p, and --top-k parameters, alongside:

  • --lang (en, pt, fr, de; optional, helps pronunciation on ambiguous text)
  • --int8 (int8 AR weights on CPU)
  • --steps (acoustic solver steps; default 2)
  • --max-seconds (cap per generated segment; long text is split into segments, so total length is unbounded)

Python

Non-streaming

from sopro import SoproTTS

tts = SoproTTS.from_pretrained("samuel-vitorino/sopro-v2-turbo", device="cpu")

wav = tts.synthesize(
    "Hello! This is a non-streaming Sopro TTS example.",
    ref_audio_path="ref.wav",
)

tts.save_wav("out.wav", wav)

Streaming

import torch
from sopro import SoproTTS

tts = SoproTTS.from_pretrained("samuel-vitorino/sopro-v2-turbo", device="cpu")

chunks = []
for chunk in tts.stream(
    "Hello! This is a streaming Sopro TTS example.",
    ref_audio_path="ref.mp3",
):
    chunks.append(chunk.cpu())

wav = torch.cat(chunks, dim=-1)
tts.save_wav("out_stream.wav", wav)

You can also precalculate the reference to reduce time-to-first-audio:

import torch
from sopro import SoproTTS

tts = SoproTTS.from_pretrained("samuel-vitorino/sopro-v2-turbo", device="cpu")

ref = tts.prepare_reference(ref_audio_path="ref.mp3", stream=True)

chunks = []
for chunk in tts.stream(
    "Hello! This is a streaming Sopro TTS example.",
    ref=ref,
):
    chunks.append(chunk.cpu())

wav = torch.cat(chunks, dim=-1)
tts.save_wav("out_stream.wav", wav)

Disclaimers

  • We did not add watermarking: with an open-source inference pipeline it would be trivial to remove, so it would only provide a false sense of safety. Please use the model for good: do not impersonate people.
  • The text frontend is deliberately minimal, so some abbreviations, numbers, and symbols may not be pronounced correctly. Prefer words: 1 + 2 should be written one plus two. That said, Sopro generally reads common abbreviations like "CPU" or "TTS" fine, and you can put a language-specific normalizer in front of it.
  • Mixed-language text is a weak spot: words from one language inside a sentence of another (an English product name in a Portuguese sentence, for example) can be mispronounced.
  • The streaming path (chunked attention and the causal vocoder) is not bit-exact with the offline path. For best quality, prefer the offline path.
  • We are not planning to release the training code in the near future due to its complexity.

Training data


Acknowledgements

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sopro-2.0.0.tar.gz (54.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sopro-2.0.0-py3-none-any.whl (62.9 kB view details)

Uploaded Python 3

File details

Details for the file sopro-2.0.0.tar.gz.

File metadata

  • Download URL: sopro-2.0.0.tar.gz
  • Upload date:
  • Size: 54.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.20

File hashes

Hashes for sopro-2.0.0.tar.gz
Algorithm Hash digest
SHA256 2cef7b26f3d81635b3e92b4185009ce6abaa9b493ba822a5d3a6578a2c32c2e7
MD5 b88e2e8c0d0cacc56e2333d5c20525fb
BLAKE2b-256 f740947c7af5cb5c222ccba31643565562eb774d0a8738766c9bf19b14361f52

See more details on using hashes here.

File details

Details for the file sopro-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: sopro-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 62.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.20

File hashes

Hashes for sopro-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f7fefdd7d946781bf191a01f211a5c01a6703d06b600a2e990efcd9b9deb1662
MD5 d0f8352c92a669b6172e111b08f992c8
BLAKE2b-256 18638cb5a035563b8da9aa30b58a16fc064219ff9d6c4da85a83f367b643b937

See more details on using hashes here.

Release history Release notifications | RSS feed

2.2.0

2 files

2.1.1

2 files

2.1.0

2 files

2.0.5

2 files

2.0.4

2 files

2.0.3

2 files

2.0.2

2 files

2.0.1

2 files

This release

2.0.0 This release

2 files

1.5.0

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page