Speak Response

Vocalize text using local Qwen3-TTS. Default voice is the Oracle (cloned from a Dune narrator with deep, resonant, prophetic quality).

Quick Examples

Command	Effect
/speak	Last 2 sentences with Oracle voice
/speak 5	Last 5 sentences with Oracle voice
/speak "The sleeper must awaken."	Specific text with Oracle voice
/speak --preset mood:warm	Last 2 sentences with preset speaker + emotion
/speak --preset "Hello" speaker:Vivian voice:"nurturing"	Preset speaker with custom voice

Default: Oracle Voice

The oracle voice is a deep, resonant, prophetic voice cloned from a Dune narrator. It speaks all text with a sense of ancient wisdom and gravitas.

# Default usage - Oracle voice
scripts/speak.sh "The spice must flow."
scripts/speak.sh "He who controls the spice controls the universe."

Limitation

The Oracle uses voice cloning (Base model), which does not support per-message instruction control. The voice characteristics are fixed. For emotion/mood control, use --preset.

Preset Speakers (--preset)

For emotion and mood control, use --preset to switch to CustomVoice with adjustable instructions:

scripts/speak.sh --preset "<text>" [speaker] [instruction]

Quick Preset Examples

# Calm therapeutic voice
scripts/speak.sh --preset "Take a deep breath." Vivian "calm, nurturing, gentle pace"

# Excited announcement
scripts/speak.sh --preset "We did it!" Ryan "joyful, excited, enthusiastic"

# Serious explanation
scripts/speak.sh --preset "This is important." Eric "serious, measured, emphatic"

Custom Voice Instructions

The model understands rich natural language descriptions:

Aspect	Examples
Emotion	joyful, melancholic, anxious, calm, excited, contemplative
Pace	slow and deliberate, rapid and energetic, measured, hesitant
Intensity	soft and gentle, loud and commanding, whispered, emphatic
Style	warm and nurturing, professional, playful, dramatic
Prosody	with dramatic pauses, rising intonation, emphatic on key words

Mood Presets (Shortcuts)

Preset	Expands To
calm	"calm, soothing, gentle pace"
warm	"warm, empathetic, nurturing tone"
excited	"joyful, excited, enthusiastic"
serious	"serious, measured, authoritative"
gentle	"soft, gentle, whispered"
encouraging	"encouraging, uplifting, sincere"
contemplative	"thoughtful, slow pace, reflective"

Speakers

Speaker	Best For
Ryan (default)	Professional, serious, authoritative
Vivian	Warm, nurturing, therapeutic
Serena	Calm, gentle, contemplative
Dylan	Friendly, casual, playful
Eric	Serious, dramatic, commanding
Aiden	Encouraging, uplifting, energetic
Uncle_Fu	Wise, measured
Ono_Anna	Soft, gentle
Sohee	Clear, professional

Workflow

1. Parse arguments for text and mode (default oracle vs --preset)
2. Extract text from last response if not provided
3. Default mode: Clone with Oracle voice
4. Preset mode: Generate with CustomVoice + instruction
5. Audio plays through macOS speakers

Execution

# Oracle voice (default)
scripts/speak.sh "<text>"

# Preset speaker with instruction
scripts/speak.sh --preset "<text>" [speaker] [instruction]

Voice Cloning (Custom Voices)

Clone any voice from a 3+ second audio sample:

# Get transcript first (use Whisper API)
curl -s https://api.openai.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F file="@reference.mp3" -F model="whisper-1"

# Clone the voice
scripts/clone.sh "<text to speak>" "<audio_file>" "<transcript>"

Voice Design (Create New Voices)

Design entirely new voices from natural language descriptions:

scripts/design-voice.sh "<sample_text>" "<voice_description>"

# Example: Create a warm guide voice
scripts/design-voice.sh \
  "Take a deep breath and feel this moment." \
  "warm, nurturing, gentle pace, empathetic, female"

Then clone the designed voice for reuse:

scripts/clone.sh "New text" designed-voice.wav "Original sample text"

See references/moods.md for more instruction examples.