Merge pull request #4239 from pipecat-ai/mb/remove-deprecation-module-proxy

Remove DeprecatedModuleProxy and service re-export shims

changelog/4239.removed.md

@@ -0,0 +1 @@
+- ⚠️ Removed `DeprecatedModuleProxy` and all service `__init__.py` re-export shims. Flat imports like `from pipecat.services.openai import OpenAILLMService` no longer work. Use the full submodule path instead: `from pipecat.services.openai.llm import OpenAILLMService`. This is already the established pattern across all examples and internal code.

examples/context-summarization/context-summarization-google.py

@@ -36,7 +36,7 @@ from pipecat.runner.types import RunnerArguments
 from pipecat.runner.utils import create_transport
 from pipecat.services.cartesia.tts import CartesiaTTSService
 from pipecat.services.deepgram.stt import DeepgramSTTService
-from pipecat.services.google import GoogleLLMService
+from pipecat.services.google.llm import GoogleLLMService
 from pipecat.services.llm_service import FunctionCallParams
 from pipecat.transports.base_transport import BaseTransport, TransportParams
 from pipecat.transports.daily.transport import DailyParams

examples/transcription/transcription-gladia.py

@@ -16,7 +16,7 @@ from pipecat.pipeline.task import PipelineTask
 from pipecat.processors.frame_processor import FrameDirection, FrameProcessor
 from pipecat.runner.types import RunnerArguments
 from pipecat.runner.utils import create_transport
-from pipecat.services.gladia import GladiaSTTService
+from pipecat.services.gladia.stt import GladiaSTTService
 from pipecat.transports.base_transport import BaseTransport, TransportParams
 from pipecat.transports.daily.transport import DailyParams
 from pipecat.transports.websocket.fastapi import FastAPIWebsocketParams

pyproject.toml

@@ -209,7 +209,6 @@ ignore = [
 "**/__init__.py" = ["D104"]
 # Skip specific rules for generated protobuf files
 "**/*_pb2.py" = ["D"]
-"src/pipecat/services/__init__.py" = ["D"]
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"

src/pipecat/services/__init__.py

@@ -1,40 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-from typing import Any, Dict
-
-# Track which modules we've already warned about
-_warned_modules = set()
-
-
-def _warn_deprecated_access(globals: Dict[str, Any], attr, old: str, new: str):
-    # Only warn once per old->new module pair
-    module_key = (old, new)
-    if module_key not in _warned_modules:
-        import warnings
-
-        with warnings.catch_warnings():
-            warnings.simplefilter("always")
-            warnings.warn(
-                f"Module `pipecat.services.{old}` is deprecated, use `pipecat.services.{new}` instead.",
-                DeprecationWarning,
-                stacklevel=3,
-            )
-        _warned_modules.add(module_key)
-
-    return globals[attr]
-
-
-class DeprecatedModuleProxy:
-    def __init__(self, globals: Dict[str, Any], old: str, new: str):
-        self._globals = globals
-        self._old = old
-        self._new = new
-
-    def __getattr__(self, attr):
-        if attr in self._globals:
-            return _warn_deprecated_access(self._globals, attr, self._old, self._new)
-        raise AttributeError(f"module 'pipecat.services.{self._old}' has no attribute '{attr}'")

src/pipecat/services/anthropic/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "anthropic", "anthropic.llm")

src/pipecat/services/assemblyai/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .stt import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "assemblyai", "assemblyai.stt")

src/pipecat/services/aws/__init__.py

@@ -1,18 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .agent_core import *
-from .llm import *
-from .nova_sonic import *
-from .sagemaker import *
-from .stt import *
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "aws", "aws.[llm,stt,tts]")

src/pipecat/services/azure/__init__.py

@@ -1,15 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-from .stt import *
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "azure", "azure.[llm,stt,tts]")

src/pipecat/services/cartesia/__init__.py

@@ -1,14 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .stt import *
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "cartesia", "cartesia.[stt,tts]")

src/pipecat/services/cerebras/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "cerebras", "cerebras.llm")

src/pipecat/services/deepgram/__init__.py

@@ -1,16 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .flux import *
-from .sagemaker import *
-from .stt import *
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "deepgram", "deepgram.[stt,tts]")

src/pipecat/services/deepseek/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "deepseek", "deepseek.llm")

src/pipecat/services/elevenlabs/__init__.py

@@ -1,14 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .stt import *
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "elevenlabs", "elevenlabs.[stt,tts]")

src/pipecat/services/fal/__init__.py

@@ -1,14 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .image import *
-from .stt import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "fal", "fal.[image,stt]")

src/pipecat/services/fireworks/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "fireworks", "fireworks.llm")

src/pipecat/services/fish/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "fish", "fish.tts")

src/pipecat/services/gladia/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .stt import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "gladia", "gladia.stt")

src/pipecat/services/google/__init__.py

@@ -1,22 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .frames import *
-from .gemini_live import *
-from .image import *
-from .llm import *
-from .rtvi import *
-from .stt import *
-from .tts import *
-from .vertex import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(
-    globals(), "google", "google.[frames,image,llm,vertex,rtvi,stt,tts]"
-)

src/pipecat/services/google/gemini_live/__init__.py

@@ -1,9 +0,0 @@
-from .file_api import GeminiFileAPI
-from .llm import GeminiLiveLLMService
-from .vertex.llm import GeminiLiveVertexLLMService
-
-__all__ = [
-    "GeminiFileAPI",
-    "GeminiLiveLLMService",
-    "GeminiLiveVertexLLMService",
-]

src/pipecat/services/grok/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *  # noqa: F401,F403
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "grok", "xai.llm")

src/pipecat/services/groq/__init__.py

@@ -1,15 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-from .stt import *
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "groq", "groq.[llm,stt,tts]")

src/pipecat/services/lmnt/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "lmnt", "lmnt.tts")

src/pipecat/services/mem0/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .memory import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "mem0", "mem0.memory")

src/pipecat/services/minimax/__init__.py

@@ -1,8 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-
-from .tts import *

src/pipecat/services/moondream/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .vision import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "moondream", "moondream.vision")

src/pipecat/services/neuphonic/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "neuphonic", "neuphonic.tts")

src/pipecat/services/ollama/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "ollama", "ollama.llm")

src/pipecat/services/openai/__init__.py

@@ -1,18 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .image import *
-from .llm import *
-from .realtime import *
-from .responses.llm import *
-from .stt import *
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "openai", "openai.[image,llm,stt,tts]")

src/pipecat/services/openrouter/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "openrouter", "openrouter.llm")

src/pipecat/services/perplexity/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "perplexity", "perplexity.llm")

src/pipecat/services/piper/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "piper", "piper.tts")

src/pipecat/services/qwen/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "qwen", "qwen.llm")

src/pipecat/services/rime/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "rime", "rime.tts")

src/pipecat/services/sambanova/__init__.py

@@ -1,7 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-from .llm import *

src/pipecat/services/sarvam/__init__.py

@@ -1,7 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-from .tts import *

src/pipecat/services/simli/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .video import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "simli", "simli.video")

src/pipecat/services/tavus/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .video import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "tavus", "tavus.video")

src/pipecat/services/together/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .llm import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "together", "together.llm")

src/pipecat/services/whisper/__init__.py

@@ -1,14 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .base_stt import *
-from .stt import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "whisper", "whisper.stt")

src/pipecat/services/xtts/__init__.py

@@ -1,13 +0,0 @@
-#
-# Copyright (c) 2024-2026, Daily
-#
-# SPDX-License-Identifier: BSD 2-Clause License
-#
-
-import sys
-
-from pipecat.services import DeprecatedModuleProxy
-
-from .tts import *
-
-sys.modules[__name__] = DeprecatedModuleProxy(globals(), "xtts", "xtts.tts")