Skip to main content

speak

Make your computer talk, right from the terminal. Powered by Supertonic 3 — everything runs locally on your CPU. No cloud, no API keys, works offline.

speak "hello world"
speak -v noah "a different voice"
speak "مرحبا بالعالم"                # language detected automatically
speak -o clip.wav "or save to a file"
speak < article.txt                  # long reads start speaking instantly
ollama run llama3 "tell a story" | speak --live   # voice for your LLM

Install

uv tool install speak-cli

No other setup: everything is prebuilt wheels, and the voice models (~400 MB) download automatically the first time you speak. say also works as an alias.

Voices

Ten voices, picked by name (speak --list-voices):

Female Male
sara (default) james
emma daniel
lily leo
maya ryan
nora noah

Prefer one? Make it stick: speak --set-default noah

Options

Flag Default Meaning
-v, --voice sara voice name
-s, --speed 1.05 speech speed (0.7–2.0)
-l, --lang auto language (31 supported, auto-detected from the text)
-o, --out FILE save a WAV instead of playing
--live speak piped input line by line as it arrives
--steps 8 quality vs speed (5–12)

Sprinkle in expression tags for natural delivery: speak "well <laugh> that was funny" (also <breath>, <sigh>, …).

Good to know

  • Speech streams: long texts start playing in about a second while the rest is still being synthesized — no waiting, no length limit.
  • The first call starts a small background service that keeps the model warm — repeat calls speak in under a second. It shuts itself down after 15 idle minutes; speak --stop ends it manually.
  • Auto-detection recognizes Arabic, Japanese, Korean, Russian, Greek, and Hindi by their alphabets; other Latin-script languages need a hint, e.g. --lang fr.

Licenses

CLI: MIT · Supertonic 3 model weights: OpenRAIL-M

Download files

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

Source Distribution

speak_cli-1.0.0.tar.gz (13.4 kB view details)

Uploaded Source

Built Distribution

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

speak_cli-1.0.0-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

Details for the file speak_cli-1.0.0.tar.gz.

File metadata

  • Download URL: speak_cli-1.0.0.tar.gz
  • Upload date:
  • Size: 13.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for speak_cli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 70cd580461940c48274eaf24830239af66431232bce7beca3c5804d80531c0b6
MD5 ed2e007ca971274ca56e67d8dbbb374f
BLAKE2b-256 15ca2a1a985a49b7c5d80d6f4667197b34b32fcba3ee9c70547487426b13e860

See more details on using hashes here.

File details

Details for the file speak_cli-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: speak_cli-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 15.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for speak_cli-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5b7b0dfc77f4ce2d05a1418520c75abf41617fa18161ab2fd93e0dc1bce3d328
MD5 85526473594cb71be2f8df3ec75fb285
BLAKE2b-256 0a20ea6a759a18865116fecb787a5101ca6b588ee59e0fdba72d17a375eefae5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page