CLI Installation

macOS and Linux

The fastest way to install on macOS and Linux:

curl -fsSL https://deepgram.com/install.sh | sh

The CLI requires Python 3.10 or later. This script detects your OS, uses an available Python package manager, and installs the dg command to your PATH.

Windows

In PowerShell:

iwr https://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 https://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)