CoolFace
Modelpublic

Isaaclu724/orpheus-3b-0.1-ft-Q4_K_M-GGUF

sourceHugging Faceapache-2.0updated 14d agoView on Hugging Face
0likes84downloads
Model Card

Orpheus-TTS-Local

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

{Github Repo](https://github.com/isaiahbjork/orpheus-tts-local)

Features

  • โ€”๐ŸŽง 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

Quick Setup

  1. 1.Install LM Studio
  2. 2.Install the Orpheus TTS model (orpheus-3b-0.1-ft-q4_k_m.gguf) in LM Studio
  3. 3.Load the Orpheus model in LM Studio
  4. 4.Start the local server in LM Studio (default: http://127.0.0.1:1234)
  5. 5.Install dependencies:
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
  1. 1.Run the script:
   python gguf_orpheus.py --text "Hello, this is a test" --voice tara

Usage

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

Options

  • โ€”--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)

Available Voices

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

Emotion

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

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

License

Apache 2.0