free-groq-voice

# Free Groq Voice Recognition

## Overview

**100% FREE** voice recognition powered by Groq's complimentary Whisper API (whisper-large-v3 model). No credit card required, no usage limits.

Convert audio messages, voice notes, and recordings to text in 50+ languages. Perfect for:
- 🎙️ Voice message transcription
- 📝 Meeting notes
- ♿ Accessibility features
- 🤖 Voice-controlled automation

## Cost: $0.00

- ✅ **Completely free** Groq API tier
- ✅ No credit card needed
- ✅ No monthly fees
- ✅ Generous rate limits
- ✅ Whisper-large-v3 model (most accurate)

## Setup

### 1. Get Your FREE Groq API Key

1. Visit https://console.groq.com/
2. Sign up for free (takes 30 seconds)
3. Navigate to API Keys
4. Create a new API key
5. Copy the key

**That's it! No payment required.**

### 2. Configure Proxy (If in Restricted Regions)

Groq API may require a proxy in certain regions (e.g., mainland China).

**Add to your TOOLS.md:**
```markdown
### Proxy Settings
- HTTP Proxy: http://127.0.0.1:7890

### Voice Recognition (FREE Groq Whisper)
- API Key: gsk_your_key_here
- Model: whisper-large-v3
- Language: zh (or your preferred language)
- Requires Proxy: Yes (if in restricted region)
```

### 3. Test the Skill

Send a voice message and ask me to transcribe it!

## Usage Examples

**Basic Transcription:**
```
User: [sends voice message]
You: You said: "你好，这是一条测试消息"
```

**With Language Hint:**
```
User: 识别这段英文语音
You: [automatically uses language=en]
```

**Batch Processing:**
```
User: 帮我识别这个文件夹里所有的语音文件
You: [processes all .ogg/.mp3/.wav files]
```

## Supported Languages

- 🇨🇳 Chinese (zh) - Mandarin, Cantonese
- 🇺🇸 English (en) - US, UK, Australian
- 🇯🇵 Japanese (ja)
- 🇰🇷 Korean (ko)
- 🇫🇷 French (fr)
- 🇩🇪 German (de)
- 🇪🇸 Spanish (es)
- 🇮🇹 Italian (it)
- 🇵🇹 Portuguese (pt)
- 🇷🇺 Russian (ru)
- ... and 40+ more

## Technical Details

**API Endpoint:**
```
https://api.groq.com/openai/v1/audio/transcriptions
```

**Model:** `whisper-large-v...

# Free Groq Voice Recognition Skill

**100% FREE voice-to-text using Groq's complimentary Whisper API**

## Quick Start

1. **Get FREE API Key**: https://console.groq.com/ (30 seconds, no credit card)
2. **Add to TOOLS.md**:
   ```markdown
   ### Voice Recognition (FREE Groq Whisper)
   - API Key: gsk_your_key_here
   - Model: whisper-large-v3
   - Language: zh
   - Proxy: http://127.0.0.1:7890 (if needed)
   ```
3. **Send voice message** → Get instant transcription

## Features

✅ **Completely FREE** - No payment required  
✅ **50+ Languages** - Chinese, English, Japanese, Korean, etc.  
✅ **High Accuracy** - Whisper-large-v3 (best model)  
✅ **Fast** - Powered by Groq's LPU chip  
✅ **Easy Setup** - Just add API key  

## Cost Comparison

| Service | Cost |
|---------|------|
| **Groq (This)** | **FREE** |
| OpenAI Whisper | $0.006/min |
| Google Speech | $0.006/min |
| AWS Transcribe | $0.024/min |

**Save hundreds of dollars per year!**

## Requirements

- Groq API key (FREE)
- Proxy (if in restricted regions)
- Bash shell (macOS/Linux)

## License

MIT - Free to share and modify