voice

Voice — Speak Through Speaker

Quick Start

Your chat replies are automatically spoken aloud through TTS. Use this skill only when you need to speak additional or separate text outside your normal reply (e.g., parallel speech during tool calls, or text different from your chat reply).

Workflow

1. Determine if you need explicit speech beyond your normal reply:
   • Normal conversational reply -> do NOT call this skill, TTS is automatic
   • Need to speak while also performing tool calls -> use POST /voice/speak
   • Need to speak different text than your chat reply -> use POST /voice/speak
   • Reacting to a sensing event before reply is finalized -> use POST /voice/speak
2. Optionally check if TTS is busy: GET /voice/status
3. If tts_speaking is true, wait or skip
4. Call POST /voice/speak with plain text

Examples

Input: Normal conversational reply Output: Do NOT call this skill. Just reply normally — your text is automatically spoken.

Input: You need to greet the user while also activating a scene Output: Call POST /voice/speak with {"text": "Good morning!"} in parallel with the Scene API call.

Input: You want to say something different from your chat reply Output: Call POST /voice/speak with the spoken text. Then provide your chat reply separately.

Input: User says "say something" / "tell me a joke" Output: Do NOT call this skill. Just reply normally with the joke — automatic TTS handles it.

Tools

Use Bash with curl to call the HTTP API at http://127.0.0.1:5001.

Speak text

curl -s -X POST http://127.0.0.1:5001/voice/speak \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello, this is a test."}'

Text max 2000 characters. Returns immediately; audio plays in background.

Check voice status

curl -s http://127.0.0.1:5001/voice/status

Response:

{
  "voice_available": true,
  "voice_listening": false,
  "tts_available": true,
  "tts_speaking": false
}

Error Handling

• If tts_speaking is true, the speaker is busy. Wait briefly or skip the explicit speech.
• If voice_available or tts_available is false, inform the user: "Voice output is currently unavailable."
• If the API is unreachable, fall back to chat-only reply. Speech is non-critical.