Installation

clawhub install huixionghexiyi/free-groq-voice

Summary

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

SKILL.md

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:

text
User: [sends voice message]
You: You said: "ไฝ ๅฅฝ๏ผŒ่ฟ™ๆ˜ฏไธ€ๆกๆต‹่ฏ•ๆถˆๆฏ"

With Language Hint:

text
User: ่ฏ†ๅˆซ่ฟ™ๆฎต่‹ฑๆ–‡่ฏญ้Ÿณ
You: [automatically uses language=en]

Batch Processing:

text
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:

text
https://api.groq.com/openai/v1/audio/transcriptions

Model: whisper-large-v3 (OpenAI's most accurate model)

Supported Formats:

  • OGG/OPUS (Feishu, Telegram default)
  • MP3
  • WAV
  • M4A
  • WebM

Proxy Requirements:

  • Use HTTP proxy (not SOCKS5)
  • Default: http://127.0.0.1:7890

Troubleshooting

โŒ "Forbidden" Error:

  • Check API key is valid
  • Ensure proxy is configured (if in restricted region)
  • Try HTTP proxy instead of SOCKS5

โŒ "File Not Found":

  • Check file path is absolute
  • Ensure file exists

โŒ Slow Response:

  • Check proxy speed
  • Groq API is usually fast (< 1s for short audio)

Privacy & Security

  • โœ… Audio processed by Groq's API (not stored permanently)
  • โœ… API key stored locally in your TOOLS.md
  • โœ… No data sent to third parties
  • โœ… Open-source and auditable

Why Groq?

FREE vs Paid Alternatives:

ServiceCostAccuracySpeed
Groq (FREE)$0โญโญโญโญโญโšกโšกโšกโšกโšก
OpenAI Whisper$0.006/minโญโญโญโญโญโšกโšกโšก
Google Speech$0.006/minโญโญโญโญโšกโšกโšกโšก
AWS Transcribe$0.024/minโญโญโญโญโšกโšกโšก

Groq's free tier offers:

  • Same Whisper-large-v3 model as OpenAI
  • Faster inference (Groq's LPU chip)
  • No usage limits (fair use policy)
  • No credit card required

Contributing

Want to improve this skill?

  • Fork on ClawHub
  • Submit improvements
  • Share with the community

License

MIT - Free to use, modify, and distribute.


Enjoy FREE voice recognition! ๐ŸŽ‰

No more paying for transcription services. Groq's complimentary API makes professional-grade speech-to-text accessible to everyone.

Recommended skills

Browse all โ†’

Related guides

Hand-picked reading to help you choose, install, and use agent skills.