voicers

Category: Content & Multimedia | Uploader: rgbkrk | Downloads: 0 | Version: v1.0（Latest）

`voice` speaks text aloud using Kokoro TTS on Apple Silicon. Use it to get your user's attention, read back content, or confirm actions audibly.

Changelog: Source: GitHub https://github.com/rgbkrk/voicers

Directory Structure

Current level: Root

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 668 B
📁 crates/
- 📁 voice-cli/
  - 📁 src/
    
    📄 main.rs 20.9 KB
  - 📄 build.rs 5.0 KB
  - 📄 Cargo.toml 532 B
  - 📄 README.md 1.4 KB
- 📁 voice-dsp/
  - 📁 src/
    
    📄 lib.rs 17.8 KB
  - 📄 Cargo.toml 267 B
  - 📄 README.md 1.1 KB
- 📁 voice-g2p/
  - 📁 data/
    
    📁 tagger/
    
    📄 classes.txt 149 B
    
    📄 tags.json 25.2 KB
    
    📄 weights.json 132 B
    
    📄 us_gold.json 2.9 MB
    
    📄 us_silver.json 3.0 MB
  - 📁 src/
    
    📄 espeak.rs 8.6 KB
    
    📄 lexicon.rs 45.3 KB
    
    📄 lib.rs 19.4 KB
    
    📄 number.rs 8.4 KB
    
    📄 stress.rs 10.4 KB
    
    📄 tagger.rs 9.7 KB
    
    📄 token.rs 8.4 KB
    
    📄 tokenizer.rs 17.9 KB
  - 📄 Cargo.toml 389 B
  - 📄 README.md 1.7 KB
- 📁 voice-nn/
  - 📁 src/
    
    📁 vocoder/
    
    📄 decoder.rs 11.4 KB
    
    📄 generator.rs 10.0 KB
    
    📄 mod.rs 52 B
    
    📄 source.rs 12.8 KB
    
    📄 ada_norm.rs 5.9 KB
    
    📄 albert.rs 16.9 KB
    
    📄 conv_weighted.rs 6.1 KB
    
    📄 lib.rs 127 B
    
    📄 lstm.rs 4.7 KB
    
    📄 prosody.rs 13.6 KB
    
    📄 text_encoder.rs 4.9 KB
  - 📄 Cargo.toml 399 B
  - 📄 README.md 1.1 KB
- 📁 voice-tts/
  - 📁 data/
    
    📁 voices/
    
    📄 af_bella.safetensors 131 B
    
    📄 af_heart.safetensors 131 B
    
    📄 af_sarah.safetensors 131 B
    
    📄 af_sky.safetensors 131 B
    
    📄 am_adam.safetensors 131 B
    
    📄 am_michael.safetensors 131 B
    
    📄 bf_emma.safetensors 131 B
    
    📄 config.json 2.3 KB
  - 📁 src/
    
    📄 builtin.rs 3.1 KB
    
    📄 config.rs 988 B
    
    📄 error.rs 503 B
    
    📄 lib.rs 2.0 KB
    
    📄 model.rs 8.1 KB
    
    📄 voice.rs 1.4 KB
    
    📄 weights.rs 13.9 KB
  - 📁 tests/
    
    📄 istft_roundtrip.rs 3.1 KB
  - 📄 Cargo.toml 539 B
  - 📄 README.md 1.6 KB
📁 notebooks/
- 📄 g2p_test_harness.ipynb 11.2 KB
- 📄 stt_comparison.ipynb 8.9 KB
- 📄 vocoder_comparison.ipynb 40.3 KB
📄 .gitattributes 157 B
📄 .gitignore 19 B
📄 AGENTS.md 5.2 KB
📄 Cargo.lock 91.2 KB
📄 Cargo.toml 50 B
📄 CLAUDE.md 9 B
📄 LICENSE 1.0 KB
📄 README.md 9.0 KB
📄 SKILL.md 1.7 KB

SKILL.md

# voice — TTS tool for AI agents

`voice` speaks text aloud using Kokoro TTS on Apple Silicon. Use it to get your user's attention, read back content, or confirm actions audibly.

## Quick reference

```bash
# Speak text
voice Hello, I finished the task.

# Speak from a pipe
echo "Build complete." | voice

# Read a file aloud (strip markdown first)
voice --markdown -f README.md

# Save to WAV instead of playing
voice -o result.wav "Here is your audio."

# Use a specific voice
voice -v am_michael "Switching to a male voice."

# Precise pronunciation via IPA phonemes
voice --phonemes "həlˈO wˈɜɹld"
```

## When to use

- **Get attention**: Speak when a long task finishes, a build fails, or you need input
- **Read content**: Pipe text through `voice` to read back docs, errors, or summaries
- **Confirm actions**: "Deploying to production" before doing something irreversible

## Tips

- Use `-q` for quiet mode — suppresses phonemes and progress, only errors print
- Put flags before the text: `voice -v af_bella "text"` not `voice "text" -v af_bella`
- For long text, `voice` automatically chunks at ~510 phonemes and streams playback
- Stderr shows phoneme output — useful for debugging pronunciation
- Use `--sub word=replacement` to fix names: `voice --sub kubectl=cube-cuddle "Restarting kubectl"`
- A `.voice-subs` file in the project root is auto-discovered for persistent fixes
- Wrap substitution values in `/slashes/` for raw phoneme overrides: `Kokoro=/kˈOkəɹO/`

## Builtin voices (no network)

`af_heart` (default), `af_bella`, `af_sarah`, `af_sky`, `am_michael`, `am_adam`, `bf_emma`

## Install

```bash
cargo install voice
```

Requires macOS with Apple Silicon. Model weights download on first run (~312MB, cached).

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

voicers

Directory Structure

SKILL.md

Report

Notice