transcribe

Topics in the source

• Audio Transcribe
• Workflow
• Decision rules
• Output conventions
• Dependencies (install if missing)
• Environment
• Skill path (set once)
• CLI quick start

Transcribe audio using OpenAI, with optional speaker diarization when requested. Prefer the bundled CLI for deterministic, repeatable runs. 1. Collect inputs: audio file path(s), desired response format (text/json/diarizedjson), optional language hint, and any known speaker references. 2. Verify OPENAIAPIKEY is set. If missing, ask the user to set it locally (do not ask them to paste the key). 3. Run the bundled transcribediarize.py CLI with sensible defaults (fast text transcription). 4. Validate the output: transcription quality, speaker labels, and segment boundaries; iterate with a single targeted change if needed. 5. Save outputs under output/transcribe/ when working in this repo. Default to gpt-4o-mini-transcribe with --response-format text for fast transcription. If the user wants speaker labels or diarization, use --model gpt-4o-transcribe-diarize --response-format diarizedjson. If audio is longer than 30 seconds, keep --chunking-strategy auto. Prompting is not supported for gpt-4o-transcribe-diarize. Use output/transcribe/ / for evaluation runs. Use --out-dir for multiple files to avoid overwriting. Prefer uv for dependency management. If uv is unavailable: OPENAIAPIKEY mu

This is an excerpt. Refer to the complete source and its current requirements.