terminal-voice 0.1.0

A programmable terminal personality that speaks when you type wrong commands.

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:

pip install terminal-voice

2. Accept the Coqui TTS Terms of Service (required once):

export COQUI_TOS_AGREED=1

2. Upload a 10-30 second voice sample (a clean .wav file is best):

voice upload-voice path/to/your/voice.wav

3. Add some custom rules:

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:

command_not_found_handler() {
    voice speak "$1"
}

5. Reload your shell:

source ~/.zshrc

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