1 files changed, 7 insertions, 1 deletions

diff --git a/README.md b/README.md
index 9b1fea9..55ca02d 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,7 @@ The following binaries must be available on `PATH`:
 - `ffmpeg` — audio decoding/encoding for playback, conversion, and compression
 - `qalc` (Qalculate) — used by `/math` to evaluate expressions
 - `yt-dlp` (optional) — used by `/download`
+- `piper` (optional) — local TTS for `/tts` and `/senator ... tts_vc`; falls back to Google Translate TTS if unavailable
 
 Unlike the Python version, QR encode/decode is handled by the pure-Rust
 `qrcode`/`rxing` crates — no `zbar` system library required.
@@ -44,6 +45,11 @@ On launch, missing variables are reported via tracing (`error!` for required,
 `warn!` for optional with defaults). The database and schema migrations are
 created automatically on first run.
 
+For local TTS, set `TTS_MODEL_PATH` to a Piper `.onnx` model file (or a
+directory of models, in which case `TTS_VOICE` selects the model, defaulting to
+`pl_PL-bass-high`). When `TTS_MODEL_PATH` is unset or Piper is unavailable, the
+bot falls back to Google Translate TTS.
+
 ### 5. Run
 
 ```bash
@@ -65,7 +71,7 @@ servers.
 - `/join` — join the caller's voice channel
 
 ### TTS
-- `/tts` — Google Translate TTS (Polish), sent as a file or played in voice
+- `/tts` — local Piper TTS (Polish, Google Translate fallback), sent as a file or played in voice
 
 ### Search & Web
 - `/web` — DuckDuckGo HTML scrape (soon to use 4get)