Skip to main content
Deepgram's Docs

Search documentation

Type to search this documentation.

On this pageOverview

CLI Installation

The fastest way to install on macOS and Linux:

Shell
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.

In PowerShell:

powershell
iwr https://deepgram.com/install.ps1 -useb | iex

On macOS and Linux:

Shell
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.

Shell
pip install deepctl
Shell
pipx install deepctl
Shell
uv tool install deepctl
Shell
dg --version
dg --help

If you installed via Homebrew:

Shell
brew upgrade deepgram

Otherwise, re-run the install script:

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

Or update via pip:

Shell
pip install --upgrade deepctl
Shell
brew uninstall deepgram   # Homebrew
pip uninstall deepctl     # pip
uv tool uninstall deepctl # uv
  • Python 3.10 or later
  • ffmpeg (for audio processing — installed automatically when using Homebrew)
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu