CLI Installation
macOS and Linux
Section titled “macOS and Linux”The fastest way to install on macOS and Linux:
curl -fsSL https://deepgram.com/install.sh | shThe 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
Section titled “Windows”In PowerShell:
iwr https://deepgram.com/install.ps1 -useb | iexPackage Managers
Section titled “Package Managers”Homebrew
Section titled “Homebrew”On macOS and Linux:
brew tap deepgram/tap
brew install deepgramThe 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 install deepctlpipx install deepctluv tool install deepctlVerify Installation
Section titled “Verify Installation”dg --version
dg --helpUpdate
Section titled “Update”If you installed via Homebrew:
brew upgrade deepgramOtherwise, re-run the install script:
curl -fsSL https://deepgram.com/install.sh | shOr update via pip:
pip install --upgrade deepctlUninstall
Section titled “Uninstall”brew uninstall deepgram # Homebrew
pip uninstall deepctl # pip
uv tool uninstall deepctl # uvRequirements
Section titled “Requirements”- Python 3.10 or later
ffmpeg(for audio processing — installed automatically when using Homebrew)