Visitar URL original
GitHub - araa47/ez-voice: Local stt,tts skills for ai agents · GitHub
Skip to content
araa47Public

About

Local stt,tts skills for ai agents

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ez-voice

Local speech-to-text and text-to-speech skills for Claude Code.

Skills

Skill Description
ez-stt Local speech-to-text using Parakeet (best English accuracy) or Whisper (fastest, multilingual)
ez-tts Local text-to-speech using Kyutai Pocket TTS with 8 preset voices and voice cloning

Both skills run fully offline after initial model download. TTS supports english, french, german, portuguese, italian, and spanish. A Hugging Face token (HF_TOKEN) is needed for model download / voice cloning (accept terms on https://huggingface.co/kyutai/pocket-tts).

Installation

npx skills add araa47/ez-voice

This installs both ez-stt and ez-tts skills.

Requirements

  • Python 3.12+
  • uv
  • ffmpeg (for audio conversion)

Quick Start

Speech-to-Text

# Transcribe audio (Parakeet, best English accuracy)
scripts/stt.py audio.ogg

# Use Whisper backend (faster, multilingual)
scripts/stt.py audio.ogg -b whisper

Text-to-Speech

# Generate speech with default voice
uv run scripts/tts.py "Hello, world"

# Choose a voice / language
uv run scripts/tts.py "Hello, world" --voice marius
uv run scripts/tts.py "Hola mundo" --language spanish

# Output as OGG
uv run scripts/tts.py "Hello, world" --ogg

See each skill's SKILL.md for full usage details.

Contributing

  1. Install dependencies: uv sync --all-extras
  2. Make your changes
  3. Ensure pre-commit hooks pass: prek run --all-files
  4. Ensure tests pass: uv run -m pytest
  5. Submit a PR

About

Local stt,tts skills for ai agents

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages