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

# If you don't have uv installed, run this first:
curl -LsSf https://astral.sh/uv/install.sh | sh                              # Linux / macOS
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"   # Windows

# if you do just run this command
uv tool install speak-cli

The voice models (~400 MB) download automatically the first time you speak. Works on Linux, macOS, and Windows.

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 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

Metadata

Release files for speak-cli 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for speak-cli 1.2.0
File Size Uploaded
speak_cli-1.2.0.tar.gz 17.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for speak-cli 1.2.0
File Interpreter ABI Platform
speak_cli-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 34.9 kB

Release files / speak_cli-1.2.0.tar.gz

Download URL speak_cli-1.2.0.tar.gz
Size 17.0 kB
Tags Source
SHA-256 checksum
How to use checksums
8b36cf5a7548417bdd9523acf1c0e0b8184068f7783b5c175895ef21a3fcedb0
BLAKE2b-256 checksum
How to use checksums
6966b6caa50282419e27c10ea8a970c28f8565177a7d7bf918d8012c7a7eb035
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","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}

Release files / speak_cli-1.2.0-py3-none-any.whl

Download URL speak_cli-1.2.0-py3-none-any.whl
Size 17.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
41c447d6228663d5900bfecd0e42031707f2e7fcdcdec6f35fb1cdae6de59c13
BLAKE2b-256 checksum
How to use checksums
84d61644fe0681bd7bd8593347c850c942f4cfcf72a59d446148df52cf15213d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","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}

Release history Release notifications | RSS feed

1.3.0

2 release files

This release

1.2.0 This release

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.5.0

2 release files

0.1.0

2 release 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