Feature/deepdub plugin - add Deepdub TTS plugin integration

.github/workflows/tests.yml

@@ -86,6 +86,7 @@ jobs:
         plugin:
           [
             cartesia,
+            deepdub,
             deepgram,
             elevenlabs,
             groq,
@@ -111,6 +112,7 @@ jobs:
           LIVEKIT_URL: ${{ secrets.LIVEKIT_URL }}
           LIVEKIT_API_KEY: ${{ secrets.LIVEKIT_API_KEY }}
           LIVEKIT_API_SECRET: ${{ secrets.LIVEKIT_API_SECRET }}
+          DEEPDUB_API_KEY: ${{ secrets.DEEPDUB_API_KEY }}
           DEEPGRAM_API_KEY: ${{ secrets.DEEPGRAM_API_KEY }}
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
           MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}

.gitignore

@@ -177,3 +177,5 @@ docs/
 
 # Examples for development
 examples/dev/*
+
+.cursor/*

CONTRIBUTING.md

@@ -69,6 +69,7 @@ uv pip install pip && uv run mypy --install-types --non-interactive \
     -p livekit.plugins.bithuman \
     -p livekit.plugins.cartesia \
     -p livekit.plugins.clova \
+    -p livekit.plugins.deepdub \
     -p livekit.plugins.deepgram \
     -p livekit.plugins.elevenlabs \
     -p livekit.plugins.fal \

livekit-agents/pyproject.toml

@@ -71,6 +71,7 @@ bithuman = ["livekit-plugins-bithuman>=1.4.1"]
 cambai = ["livekit-plugins-cambai>=1.4.1"]
 cartesia = ["livekit-plugins-cartesia>=1.4.1"]
 clova = ["livekit-plugins-clova>=1.4.1"]
+deepdub = ["livekit-plugins-deepdub>=0.1.0"]
 deepgram = ["livekit-plugins-deepgram>=1.4.1"]
 elevenlabs = ["livekit-plugins-elevenlabs>=1.4.1"]
 fal = ["livekit-plugins-fal>=1.4.1"]

livekit-plugins/livekit-plugins-deepdub/README.md

@@ -0,0 +1,15 @@
+# Deepdub plugin for LiveKit Agents
+
+Support for voice synthesis with [Deepdub](https://deepdub.ai/) in LiveKit Agents.
+
+## Installation
+
+```bash
+pip install livekit-plugins-deepdub
+```
+
+## Pre-requisites
+
+You'll need:
+
+- a Deepdub API key (`DEEPDUB_API_KEY`)

livekit-plugins/livekit-plugins-deepdub/livekit/plugins/deepdub/__init__.py

@@ -0,0 +1,25 @@
+"""Deepdub plugin for LiveKit Agents"""
+
+from .tts import TTS, SynthesizeStream
+from .version import __version__
+
+__all__ = ["TTS", "SynthesizeStream", "__version__"]
+
+from livekit.agents import Plugin
+
+
+class DeepdubPlugin(Plugin):
+    def __init__(self) -> None:
+        super().__init__(__name__, __version__, __package__)
+
+
+Plugin.register_plugin(DeepdubPlugin())
+
+# Cleanup docs of unexported modules
+_module = dir()
+NOT_IN_ALL = [m for m in _module if m not in __all__]
+
+__pdoc__ = {}
+
+for n in NOT_IN_ALL:
+    __pdoc__[n] = False

livekit-plugins/livekit-plugins-deepdub/livekit/plugins/deepdub/log.py

@@ -0,0 +1,3 @@
+import logging
+
+logger = logging.getLogger("livekit.plugins.deepdub")

livekit-plugins/livekit-plugins-deepdub/livekit/plugins/deepdub/models.py

@@ -0,0 +1,5 @@
+from typing import Literal
+
+TTSModels = Literal["dd-etts-1.1", "dd-etts-2.5", "dd-etts-3.0"]
+TTSAudioFormat = Literal["mp3", "opus", "mulaw", "headerless-wav", "s16le"]
+TTSSampleRate = Literal[8000, 16000, 22050, 24000, 44100, 48000]