https://github.com/deepgram/voice-agent-python-client
A Python client for Deepgram's Voice Agent API
https://github.com/deepgram/voice-agent-python-client
Last synced: 12 months ago
JSON representation
A Python client for Deepgram's Voice Agent API
- Host: GitHub
- URL: https://github.com/deepgram/voice-agent-python-client
- Owner: deepgram
- License: isc
- Created: 2024-10-01T21:07:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-02T22:32:40.000Z (about 1 year ago)
- Last Synced: 2025-06-03T08:51:27.682Z (about 1 year ago)
- Language: Python
- Size: 18.6 KB
- Stars: 9
- Watchers: 10
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# voice-agent-python-client
This is a Python client for interacting with Deepgram's Voice Agent API.
## Instructions
1. Set an environment variable with your Deepgram API key:
```
export DEEPGRAM_API_KEY=
```
2. Install the dependencies in `requirements.txt`. For example, on Ubuntu using a virtual environment:
```
python3 -m venv venv
source venv/bin/activate
pip install .
```
Or if using `uv` you can jump right in with `uv run main.py`
3. Run the client:
```
python3 main.py
# or
uv run main.py
```
If you want to see additional logging information:
```
uv run main.py --loglevel DEBUG
```
4. Start talking into your mic. This client doesn't have echo cancellation; you'll want to use headphones so the agent doesn't hear itself and think it's user speech.
If you say "goodbye" or ask the voice agent to exit, it will close the stream.