Skip to main content

1785884895192-019fcf07-71e9-75bf-8467-be33449f1eec

Make your computer talk, right from the terminal. Powered by Supertonic 3 — everything runs locally on your CPU.

Install

uv tool install speak-cli

The voice models (~400 MB) download automatically the first time you speak.

How to use ?

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

Note: 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.2.tar.gz (13.5 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.2-py3-none-any.whl (15.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: speak_cli-1.0.2.tar.gz
  • Upload date:
  • Size: 13.5 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.2.tar.gz
Algorithm Hash digest
SHA256 b4e6700efaa843e7be53f56c14f748f59ec031d2dd2f1a1cb85236b27aa50000
MD5 3712668c9da4f063614bf4fa0d21f506
BLAKE2b-256 62a2dee57ce7a170c8ac0731acd9572a058b1aa477a87b7ec802b361cb13a2ef

See more details on using hashes here.

File details

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

File metadata

  • Download URL: speak_cli-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 15.3 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8bcc3f1815fd1a7ad169e7844d311ed0941b568cc3a0dd97e41d1ad776e4847a
MD5 62117b20afdac517374d1af73979d960
BLAKE2b-256 be58b8969bbb0dd7d158f85204a643981e2415b278ee4f86040495cc6bfd4410

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