#audio #portuguese #accessibility #speech-to-text

Audio PTBR

Premium Portuguese-Brazilian voice interface with neural TTS and Claude AI integration. Features wav2vec2-large-xlsr-53-ptBR for excellent PT-BR understanding (slang, expressions, accents) + optional Claude API for intelligent responses. Multiple neural voices (3 masculine, 1 feminine). Silent audio-in/audio-out by default with one-command installation.

Rick@henrique-simoes

Install

openclaw skills install @henrique-simoes/audio-ptbr-aprimorado

Audio PT Auto-Reply v2.0.1 - Premium Voice Interface

Complete voice interface with superior Brazilian Portuguese understanding and automatic setup.

🌟 Key Features

Superior PT-BR Understanding

Model: wav2vec2-large-xlsr-53-portuguese (jonatasgrosman)
Excellence in: Brazilian Portuguese with slang, expressions, accents
Also supports: English (multilingual)
Quality: State-of-the-art for PT-BR ASR

🤖 Optional Claude Integration

Intelligent responses using Claude API
Falls back to OpenClaw agent automatically
Optional: No API key required, still works with OpenClaw agent
Smart: Better understanding of context and Portuguese nuances

Neural Voice Options (Piper TTS)

Voice	Gender	Quality	Character
jeff	Masculina	Medium	Clear, professional
cadu	Masculina	Medium	Warm, natural
faber	Masculina	Medium	Balanced
miro	Feminina	High	Community voice

Voice Commands

Change voice anytime with:

/voz jeff - Voice: Jeff
/voz cadu - Voice: Cadu
/voz faber - Voice: Faber
/voz miro - Voice: Miro (feminina)
/voz feminina - Automatic: miro
/voz masculina - Automatic: jeff
/voz listar - Show all voices

⚡ Installation (NEW!)

One-Command Installation

bash

bash install.sh

The installer automatically:

✅ Detects your system architecture (ARM64, x86_64)
✅ Downloads Piper TTS
✅ Downloads 4 Brazilian Portuguese voice models (~240MB)
✅ Installs Python dependencies
✅ Validates everything works

No manual downloads. No configuration. Just one command!

🔄 Critical Rules

DEFAULT: AUDIO ONLY - NO TEXT

When user sends audio:

❌ NO transcription shown
❌ NO "Pesquisando...", "Gerando..."
❌ NO confirmations or explanations
✅ ONLY audio reply

TEXT MODE: Say "texto" or "responda em texto" explicitly

📊 Workflow

text

🎤 Audio Received (PT-BR/EN)
    ↓
🔤 Transcribe (wav2vec2 PT-BR - silent)
    ↓
🤖 AI Response (Claude API or OpenClaw Agent - silent)
    ↓
🗣️ Synthesize (Piper neural - silent)
    ↓
📤 Send Audio Reply (silent)

📁 Scripts

Installation & Setup

install.sh - Automatic installation (run once!)
health_check.py - Validate the installation

Core Processing

transcribe.py - wav2vec2 PT-BR speech recognition
synthesize.py - Piper TTS with voice selection
voice_config.py - Voice preference management
process.sh - Full workflow orchestration

AI Integration

claude_adapter.py - Claude API bridge (intelligent responses)

🔧 Configuration

Optional: Enable Claude Integration

For intelligent AI responses, set your API key:

bash

export ANTHROPIC_API_KEY="sk-your-api-key"

Without this, the skill uses OpenClaw's agent (still great responses!).

Voice Configuration

Current voice is saved automatically in: