Deepgram CLI Skills Guide
Tool
@deepgram/cli — command-line interface for Deepgram speech-to-text.
Install
npm install -g @deepgram/cli
Auth
deepgram login
Uses your Deepgram API key (stored locally).
Core Skill: Speech → Text
Transcribe a Local Audio File
deepgram listen prerecorded audio.wav
Transcribe with Options
deepgram listen prerecorded audio.wav \
--model nova-2 \
--language en \
--punctuate \
--diarize
Core Skill: Read / Reach Content
From URL (remote audio)
deepgram listen prerecorded https://example.com/audio.mp3
From STDIN (pipes)
cat audio.wav | deepgram listen prerecorded -
From Microphone (live)
deepgram listen microphone
Stop with
Ctrl+C
. Congrats, you just dictated reality.
Output Handling
Save Transcript
deepgram listen prerecorded audio.wav > transcript.json
Plain Text Output
deepgram listen prerecorded audio.wav --format text
Useful Flags (Memorize These)
--model
– nova-2
, general
, etc.
--language
– en
, tr
, de
, …
--punctuate
– adds punctuation
--diarize
– speaker separation
--format
– json
, text
, srt
, vtt
Typical Workflow
- Reach content (file / URL / mic)
- Run
deepgram listen
- Capture output (JSON or text)
- Post-process (search, summarize, subtitle)
Skill Summary
- CLI-based speech-to-text
- Local, remote, and live audio
- Scriptable, pipe-friendly
- Fast, accurate, no UI nonsense
Deepgram CLI: because keyboards are overrated.