The Deepgram Python SDK is the official Python library for integrating Deepgram's speech recognition, text-to-speech, and language understanding APIs into applications. Built with Fern and requiring Python 3.10 or higher, the SDK provides developers with access to world-class speech and language AI models through a well-documented interface available at developers.deepgram.com. The library is distributed via PyPI under the MIT License and includes comprehensive migration guides for users upgrading from earlier versions, with documented paths from v2 through v7.
The SDK supports multiple core use cases across Deepgram's product suite. For speech recognition, it offers both Listen v1 and the newer Listen v2 with contextual turn detection for real-time transcription, alongside file and URL-based transcription capabilities. Text-to-speech functionality enables natural-sounding speech generation from text input. The SDK also provides text analysis features for sentiment detection, topic identification, and intent recognition through the Read API, plus voice agent capabilities for building conversational AI applications. Additional management features include project administration, API key handling, and usage analytics access.
The SDK provides both synchronous and asynchronous clients, allowing developers to choose between blocking and non-blocking operation patterns. Authentication is flexible, supporting both access token and API key methods with automatic environment variable discovery through DEEPGRAM_TOKEN and DEEPGRAM_API_KEY variables. Advanced features include raw HTTP response access, configurable timeouts and retries with exponential backoff, custom HTTP client support, and a pluggable transport system that allows developers to replace the built-in websockets implementation with custom transports for alternative protocols or specialized deployments. The SageMaker transport package demonstrates this extensibility, enabling Deepgram models to run on AWS SageMaker endpoints using HTTP/2 bidirectional streaming while maintaining the standard SDK interface.
Development activity shows strong engagement from the maintainer community. The repository shares contributors with microsoft/vscode, apollographql/apollo-client, and pipecat-ai/pipecat, suggesting integration points and ecosystem connections within the broader developer community.
The SDK is primarily generated from Deepgram's API specifications, though contributions are welcomed through the documented CONTRIBUTING guide. Development setup uses Poetry for dependency management, with separate installation paths for core dependencies and example code. The project maintains a community code of conduct and provides detailed exception handling for debugging, custom request configuration options, and comprehensive API reference documentation covering all available methods, parameters, and WebSocket connection types.
