speech-use

name	speech-use
description	Generate (TTS), Transcribe (STT), and Clone voices using Google's GenAI and Cloud Speech SDKs. Supports Gemini-TTS, Chirp 3, and Instant Custom Voice.

Speech Use

Use this skill to perform Text-to-Speech (TTS), Speech-to-Text (STT), and Voice Cloning operations.

This skill uses portable Python scripts managed by uv.

Prerequisites

1. Environment Variables:

   • GOOGLE_API_KEY (for TTS via Gemini)
   • GOOGLE_CLOUD_PROJECT (Required for STT and Voice Cloning)
   • GOOGLE_APPLICATION_CREDENTIALS (Recommended for STT/Voice Cloning)

2. APIs Enabled:

   • Text-to-Speech API (texttospeech.googleapis.com)
   • Speech-to-Text API (speech.googleapis.com)

Usage

1. Generate Speech (TTS)

Generate audio from text using Gemini-TTS.

Standard Voice:

uv run skills/speech-use/scripts/generate_speech.py "Hello world, this is a test." --voice Puck --output hello.wav

Custom Voice (Cloned):

uv run skills/speech-use/scripts/generate_speech.py "This is my custom voice speaking." --voice-cloning-key "YOUR_KEY_HERE" --output custom.wav

2. Create Custom Voice (Voice Cloning)

Generate a voiceCloningKey from a reference audio file and a consent file.

Requirements:

• : 10-30s of clear speech (the voice to clone).