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.1.tar.gz (13.6 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.1-py3-none-any.whl (15.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: speak_cli-1.0.1.tar.gz
  • Upload date:
  • Size: 13.6 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.1.tar.gz
Algorithm Hash digest
SHA256 497bccf7df5ef8a908fc4108cf5662abe364a488472a895061e5b5059e4fa439
MD5 6798883e7d19d8a7f895837b9b9f1b6a
BLAKE2b-256 7f0b306bbaed89d1ec75cb4291640b3b9b3ad7fa61ce067e987ba155f99eeeef

See more details on using hashes here.

File details

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

File metadata

  • Download URL: speak_cli-1.0.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cda95a68d321fc83ded322f26034900f94b2ebe8349431a89515bb9ad3b333fd
MD5 016f6c401f71c8dc25296acdb3d4b307
BLAKE2b-256 7e01cc2e871848d9636258a80a53858e1ec9493f105c644324a427d17fa7ba31

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