Update Deepgram plugin to use SDK v5.0.0 (#98)

* Update Deepgram plugin to use SDK v5.0.0

* Merge test_realtime and test_stt and update the remaining tests

* Make deepgram.STT.start() idempotent

* Clean up unused import

* Use uv as the default package manager > pip

---------

Co-authored-by: Neevash Ramdial (Nash) <mail@neevash.dev>

Author: dangusev

plugins/deepgram/README.md

@@ -1,23 +1,24 @@
 # Deepgram Speech-to-Text Plugin
 
-A high-quality Speech-to-Text (STT) plugin for GetStream that uses the Deepgram API.
+A high-quality Speech-to-Text (STT) plugin for Vision agents that uses the Deepgram API.
 
 ## Installation
 
 ```bash
-pip install getstream-plugins-deepgram
+uv add vision-agents-plugins-deepgram
 ```
 
 ## Usage
 
 ```python
-from getstream.plugins.deepgram import DeepgramSTT
+from vision_agents.plugins import deepgram
+from getstream.video.rtc.track_util import PcmData
 
 # Initialize with API key from environment variable
-stt = DeepgramSTT()
+stt = deepgram.STT()
 
 # Or specify API key directly
-stt = DeepgramSTT(api_key="your_deepgram_api_key")
+stt = deepgram.STT(api_key="your_deepgram_api_key")
 
 # Register event handlers
 @stt.on("transcript")
@@ -29,6 +30,7 @@ def on_partial(text, user, metadata):
     print(f"Partial transcript from {user}: {text}")
 
 # Process audio
+pcm_data = PcmData(samples=b"\x00\x00" * 1000, sample_rate=48000, format="s16")
 await stt.process_audio(pcm_data)
 
 # When done
@@ -37,14 +39,16 @@ await stt.close()
 
 ## Configuration Options
 
-- `api_key`: Deepgram API key (default: reads from DEEPGRAM_API_KEY environment variable)
-- `options`: Deepgram LiveOptions for configuring the transcription
+- `api_key`: Deepgram API key (default: reads from `DEEPGRAM_API_KEY` environment variable)
+- `options`: Deepgram options for configuring the transcription.  
+See the [Deepgram Listen V1 Connect API documentation](https://github.com/deepgram/deepgram-python-sdk/blob/main/websockets-reference.md#%EF%B8%8F-parameters) for more details.
 - `sample_rate`: Sample rate of the audio in Hz (default: 16000)
 - `language`: Language code for transcription (default: "en-US")
-- `keep_alive_interval`: Interval in seconds to send keep-alive messages (default: 5.0)
+- `keep_alive_interval`: Interval in seconds to send keep-alive messages (default: 1.0s)
+- `connection_timeout`: Timeout to wait for the Deepgram connection to be established before skipping the  in seconds to send keep-alive messages (default: 15.0s)
 
 ## Requirements
 
 - Python 3.10+
-- deepgram-sdk>=4.5.0
+- deepgram-sdk>=5.0.0,<5.1
 - numpy>=2.2.6,<2.3

plugins/deepgram/pyproject.toml

@@ -12,7 +12,7 @@ requires-python = ">=3.10"
 license = "MIT"
 dependencies = [
     "vision-agents",
-    "deepgram-sdk==4.8.1",
+    "deepgram-sdk>=5.0.0,<5.1",
     "numpy>=2.2.6,<2.3",
 ]