# terminal-voice

A programmable terminal personality that intercepts failed shell commands and triggers a voice response generated from a custom voice model.

## Setup

**Note:** This package requires **Python 3.9, 3.10, or 3.11**. Python 3.12+ is not supported due to underlying AI library dependencies.

1. Install via pip:
```bash
pip install terminal-voice
```

2. Accept the Coqui TTS Terms of Service (required once):
```bash
export COQUI_TOS_AGREED=1
```

2. Upload a 10-30 second voice sample (a clean `.wav` file is best):
```bash
voice upload-voice path/to/your/voice.wav
```

3. Add some custom rules:
```bash
voice add-rule lss "It's ls, Bhanu."
voice add-rule gti "Bro... it's git."
```

4. Integrate with your shell (e.g., Zsh):
Add the following to your `~/.zshrc`:
```bash
command_not_found_handler() {
    voice speak "$1"
}
```

5. Reload your shell:
```bash
source ~/.zshrc
```

Now, typing `lss` or any other unknown command will trigger the voice response!
