A lightweight client for running Orpheus TTS locally using LM Studio API.

• 🎧 High-quality Text-to-Speech using the Orpheus TTS model
• 💻 Completely local - no cloud API keys needed
• 🔊 Multiple voice options (tara, leah, jess, leo, dan, mia, zac, zoe)
• 💾 Save audio to WAV files

1. Install LM Studio

2. Download the Orpheus TTS model (orpheus-3b-0.1-ft-q4_k_m.gguf) in LM Studio

3. Load the Orpheus model in LM Studio

4. Start the local server in LM Studio (default: http://127.0.0.1:1234)

5. Install dependencies:

   python3 -m venv venv
   source venv/bin/activate
   mise deactivate # if you use mise for version switchingreq
   pip install -r requirements.txt

6. Run the script:

   python gguf_orpheus.py --text "Hello, this is a test" --voice tara

7. Run example:

   python example.py
   mpv example_outputs/*

python gguf_orpheus.py --text "Your text here" --voice tara --output "output.wav"

• --text: The text to convert to speech
• --voice: The voice to use (default: tara)
• --output: Output WAV file path (default: auto-generated filename)
• --list-voices: Show available voices
• --temperature: Temperature for generation (default: 0.6)
• --top_p: Top-p sampling parameter (default: 0.9)
• --repetition_penalty: Repetition penalty (default: 1.1)

• tara - Best overall voice for general use (default)
• leah
• jess
• leo
• dan
• mia
• zac
• zoe

You can add emotion to the speech by adding the following tags:

<giggle>
<laugh>
<chuckle>
<sigh>
<cough>
<sniffle>
<groan>
<yawn>
<gasp>

Apache 2.0