CLI Installation

macOS and Linux

The fastest way to install on macOS and Linux:

$
curl -fsSL deepgram.com/install.sh | sh

This script detects your OS, checks for Python 3.10+, and installs the dg command to your PATH.

Windows

In PowerShell:

1
iwr deepgram.com/install.ps1 -useb | iex

Package Managers

Homebrew

On macOS and Linux:

$
brew tap deepgram/tap
$
brew install deepgram

The first command adds Deepgram’s official tap (deepgram/homebrew-tap); the second installs the CLI from it. After tapping, future installs and upgrades don’t need the deepgram/tap/ prefix — brew upgrade deepgram is enough.

Homebrew brings in ffmpeg and portaudio automatically, so dg listen --mic, dg debug probe, and the raw audio piping flows work out of the box without any further setup.

pip

$
pip install deepctl

pipx

$
pipx install deepctl

uv

$
uv tool install deepctl

Verify Installation

$
dg --version
$
dg --help

Update

If you installed via Homebrew:

$
brew upgrade deepgram

Otherwise, re-run the install script:

$
curl -fsSL deepgram.com/install.sh | sh

Or update via pip:

$
pip install --upgrade deepctl

Uninstall

$
brew uninstall deepgram   # Homebrew
$
pip uninstall deepctl     # pip
$
uv tool uninstall deepctl # uv

Requirements

• Python 3.10 or later
• ffmpeg (for audio processing — installed automatically when using Homebrew)