Add Murf AI - TTS Plugin Support (#3000)

Author: gaurav-murf

livekit-agents/pyproject.toml

@@ -92,6 +92,7 @@ liveavatar = ["livekit-plugins-liveavatar>=1.4.5"]
 lmnt = ["livekit-plugins-lmnt>=1.4.5"]
 minimax = ["livekit-plugins-minimax-ai>=1.4.5"]
 mistralai = ["livekit-plugins-mistralai>=1.4.5"]
+murf = ["livekit-plugins-murf>=1.4.5"]
 neuphonic = ["livekit-plugins-neuphonic>=1.4.5"]
 nltk = ["livekit-plugins-nltk>=1.4.5"]
 nvidia = ["livekit-plugins-nvidia>=1.4.5"]

livekit-plugins/livekit-plugins-murf/README.md

@@ -0,0 +1,15 @@
+# Murf AI plugin for LiveKit Agents
+
+Support for [Murf AI](https://murf.ai/)'s voice AI services in LiveKit Agents.
+
+More information is available in the [API docs](https://murf.ai/api/docs).
+
+## Installation
+
+```bash
+pip install livekit-plugins-murf
+```
+
+## Pre-requisites
+
+You'll need an API key from Murf AI. It can be set as an environment variable: `MURF_API_KEY` 

livekit-plugins/livekit-plugins-murf/livekit/plugins/murf/__init__.py

@@ -0,0 +1,45 @@
+# Copyright 2023 LiveKit, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Murf AI plugin for LiveKit Agents"""
+
+from .tts import TTS, ChunkedStream
+from .version import __version__
+
+__all__ = [
+    "TTS",
+    "ChunkedStream",
+    "__version__",
+]
+
+from livekit.agents import Plugin
+
+from .log import logger
+
+
+class MurfPlugin(Plugin):
+    def __init__(self) -> None:
+        super().__init__(__name__, __version__, __package__, logger)
+
+
+Plugin.register_plugin(MurfPlugin())
+
+# 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-murf/livekit/plugins/murf/log.py

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

livekit-plugins/livekit-plugins-murf/livekit/plugins/murf/models.py

@@ -0,0 +1,61 @@
+from typing import Literal
+
+TTSLocales = Literal[
+    "en-US",
+    "en-UK",
+    "en-AU",
+    "en-IN",
+    "en-SCOTT",
+    "es-ES",
+    "es-MX",
+    "hi-IN",
+    "ta-IN",
+    "bn-IN",
+    "fr-FR",
+    "de-DE",
+    "it-IT",
+    "pt-BR",
+    "zh-CN",
+    "nl-NL",
+    "ja-JP",
+    "id-ID",
+    "ko-KR",
+    "ro-RO",
+    "tr-TR",
+    "pl-PL",
+    "sk-SK",
+    "hr-HR",
+    "el-GR",
+    "bg-BG",
+]
+
+TTSModels = Literal["GEN2", "FALCON"]
+
+TTSStyles = Literal[
+    "Promo",
+    "Narration",
+    "Calm",
+    "Conversation",
+    "Conversational",
+    "Sad",
+    "Angry",
+    "Sports Commentary",
+    "Newscast",
+    "Terrified",
+    "Inspirational",
+    "Customer Support Agent",
+    "Narration",
+    "Audiobook",
+    "Storytelling",
+    "Furious",
+    "Sobbing",
+    "Wizard",
+    "Clown",
+]
+
+TTSEncoding = Literal[
+    "pcm",  # pcm_s16le
+]
+
+TTSDefaultVoiceId = "en-US-matthew"
+TTSDefaultVoiceStyle = "Conversation"

livekit-plugins/livekit-plugins-murf/livekit/plugins/murf/py.typed

@@ -0,0 +1 @@
+