README
Claudio
Give Claude a voice with real-time TTS.
https://github.com/user-attachments/assets/f535dcd9-23c2-46df-b77e-3df8ddf65284
uv tool install git+https://github.com/cleanser-labs/claudio
claudio init # picks the best TTS for your system
claudio # launches Claude Code with voice
Install
From source
git clone https://github.com/cleanser-labs/claudio.git
cd claudio
uv sync
Usage
claudio # Launch Claude with voice
claudio --speak text # Speak all text, skip code blocks
claudio --tts kokoro --voice nova # Pick backend and voice
claudio --speed 1.2 # Faster speech
claudio --persona narrator # Use a persona
claudio voices # List available voices
claudio try --voice nova # Audition a voice
Using with raw claude
You can run the proxy standalone and point any Claude Code session at it:
# Terminal 1: start the proxy
claudio proxy --speak text
# Terminal 2: launch claude with the proxy
ANTHROPIC_BASE_URL=http://127.0.0.1:9000 claude
The proxy intercepts Claude API traffic, extracts text, and speaks it through your configured TTS engine. All other API behavior is unchanged.
Speak modes
| Mode | Flag | Behavior |
|---|---|---|
tags | --speak tags | Only speaks text inside <say>...</say> tags (default). Claude needs a system prompt telling it to use <say> tags — claudio injects this automatically, but with raw claude you'll need to add it yourself. |
text | --speak text | Speaks all text automatically, skips code blocks and JSON. No special prompting needed. |
all | --speak all | Speaks everything including code blocks. |
off | --speak off | TTS disabled, proxy just forwards requests. |
For most setups with raw claude, --speak text is the easiest since it requires no prompt changes.
Guides
- Configuration — YAML schema, examples, CLI overrides
- Multi-Destination Routing — Path patterns, API key injection
- Session Logging — JSONL/SQLite storage, querying logs
- TTS Backends — Backend comparison, voice cloning, performance
Contributors
6 commits
Similar repos
Languages
Python
99.0%
README
Claudio
Give Claude a voice with real-time TTS.
https://github.com/user-attachments/assets/f535dcd9-23c2-46df-b77e-3df8ddf65284
uv tool install git+https://github.com/cleanser-labs/claudio
claudio init # picks the best TTS for your system
claudio # launches Claude Code with voice
Install
From source
git clone https://github.com/cleanser-labs/claudio.git
cd claudio
uv sync
Usage
claudio # Launch Claude with voice
claudio --speak text # Speak all text, skip code blocks
claudio --tts kokoro --voice nova # Pick backend and voice
claudio --speed 1.2 # Faster speech
claudio --persona narrator # Use a persona
claudio voices # List available voices
claudio try --voice nova # Audition a voice
Using with raw claude
You can run the proxy standalone and point any Claude Code session at it:
# Terminal 1: start the proxy
claudio proxy --speak text
# Terminal 2: launch claude with the proxy
ANTHROPIC_BASE_URL=http://127.0.0.1:9000 claude
The proxy intercepts Claude API traffic, extracts text, and speaks it through your configured TTS engine. All other API behavior is unchanged.
Speak modes
| Mode | Flag | Behavior |
|---|---|---|
tags | --speak tags | Only speaks text inside <say>...</say> tags (default). Claude needs a system prompt telling it to use <say> tags — claudio injects this automatically, but with raw claude you'll need to add it yourself. |
text | --speak text | Speaks all text automatically, skips code blocks and JSON. No special prompting needed. |
all | --speak all | Speaks everything including code blocks. |
off | --speak off | TTS disabled, proxy just forwards requests. |
For most setups with raw claude, --speak text is the easiest since it requires no prompt changes.
Guides
- Configuration — YAML schema, examples, CLI overrides
- Multi-Destination Routing — Path patterns, API key injection
- Session Logging — JSONL/SQLite storage, querying logs
- TTS Backends — Backend comparison, voice cloning, performance
Similar repos
Contributors
6 commits
Languages
Python
99.0%