# Groq Stt

> Transcribe audio files using Groq API (Whisper).

- Skill: `llblab/groq-stt` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add llblab/groq-stt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/llblab/groq-stt/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: llblab (https://skillmd.com/u/llblab)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/llblab/groq-stt

---


# Groq STT Skill

Standalone direct Node.js client for Groq's Whisper transcription API. The canonical client is `scripts/transcribe.mjs`; `scripts/transcribe.sh` is the shell entrypoint wrapper. There are no curl fallbacks or JSON parser dependencies.

## Usage

```bash
GROQ_API_KEY=xxx ./scripts/transcribe.sh audio.ogg [language] [model] [diarize]
GROQ_API_KEY=xxx ./scripts/transcribe.sh --file audio.ogg --lang ru --model whisper-large-v3-turbo --diarize true
```

- Outputs plain transcription text, or timestamped speaker segments when diarization is enabled.
- Fails fast when the file or `GROQ_API_KEY` is missing.

## CLI Options

- `--file`, `-f` — audio file path.
- `--lang`, `--language`, `-l` — optional language code; omitted means provider auto-detection.
- `--model`, `-m` — Groq transcription model; default: `whisper-large-v3-turbo`.
- `--diarize`, `-d` — `true` to label speaker segments; default: `false`.
- `--help`, `-h` — usage.

## Dependencies

- Node.js 18+ with built-in `fetch`, `FormData`, and `Blob`.
- Internet access.

## Notes

- Diarization preserves Groq's `speaker` labels without guessing or merging speakers.