Deprecate set_model, set_voice, and set_language in favor of *UpdateSettingsFrame.

src/pipecat/services/stt_service.py

@@ -9,6 +9,7 @@
 import asyncio
 import io
 import time
+import warnings
 import wave
 from abc import abstractmethod
 from typing import Any, AsyncGenerator, Dict, Mapping, Optional
@@ -168,13 +169,19 @@ class STTService(AIService):
     async def set_model(self, model: str):
         """Set the speech recognition model.
 
-        When the service has been migrated to typed settings this routes
+        .. deprecated:: 0.0.103
-        through :meth:`_update_settings_from_typed` so that concrete
+            Use ``STTUpdateSettingsFrame(model=...)`` instead.
-        services can react (e.g. reconnect) in a single place.
 
         Args:
             model: The name of the model to use for speech recognition.
         """
+        with warnings.catch_warnings():
+            warnings.simplefilter("always")
+            warnings.warn(
+                "'set_model' is deprecated, use 'STTUpdateSettingsFrame(model=...)' instead.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
         logger.info(f"Switching STT model to: [{model}]")
         if isinstance(self._settings, ServiceSettings):
             settings_cls = type(self._settings)
@@ -185,13 +192,19 @@ class STTService(AIService):
     async def set_language(self, language: Language):
         """Set the language for speech recognition.
 
-        When the service has been migrated to typed settings this routes
+        .. deprecated:: 0.0.103
-        through :meth:`_update_settings_from_typed` so that concrete
+            Use ``STTUpdateSettingsFrame(language=...)`` instead.
-        services can react (e.g. reconnect) in a single place.
 
         Args:
             language: The language to use for speech recognition.
         """
+        with warnings.catch_warnings():
+            warnings.simplefilter("always")
+            warnings.warn(
+                "'set_language' is deprecated, use 'STTUpdateSettingsFrame(language=...)' instead.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
         logger.info(f"Switching STT language to: [{language}]")
         if isinstance(self._settings, ServiceSettings):
             settings_cls = type(self._settings)

src/pipecat/services/tts_service.py

@@ -8,6 +8,7 @@
 
 import asyncio
 import uuid
+import warnings
 from abc import abstractmethod
 from dataclasses import dataclass
 from typing import (
@@ -265,13 +266,19 @@ class TTSService(AIService):
     async def set_model(self, model: str):
         """Set the TTS model to use.
 
-        When the service has been migrated to typed settings this routes
+        .. deprecated:: 0.0.103
-        through :meth:`_update_settings_from_typed` so that concrete
+            Use ``TTSUpdateSettingsFrame(model=...)`` instead.
-        services can react (e.g. reconnect) in a single place.
 
         Args:
             model: The name of the TTS model.
         """
+        with warnings.catch_warnings():
+            warnings.simplefilter("always")
+            warnings.warn(
+                "'set_model' is deprecated, use 'TTSUpdateSettingsFrame(model=...)' instead.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
         logger.info(f"Switching TTS model to: [{model}]")
         if isinstance(self._settings, ServiceSettings):
             settings_cls = type(self._settings)
@@ -282,17 +289,19 @@ class TTSService(AIService):
     async def set_voice(self, voice: str):
         """Set the voice for speech synthesis.
 
-        When the service has been migrated to typed settings this routes
+        .. deprecated:: 0.0.103
-        through :meth:`_update_settings_from_typed` so that concrete
+            Use ``TTSUpdateSettingsFrame(voice=...)`` instead.
-        services can react (e.g. reconnect) in a single place.
-
-        .. versionchanged:: 0.0.103
-            Now ``async``.  In ``__init__`` methods, set
-            ``self._voice_id`` directly instead of calling this method.
 
         Args:
             voice: The voice identifier or name.
         """
+        with warnings.catch_warnings():
+            warnings.simplefilter("always")
+            warnings.warn(
+                "'set_voice' is deprecated, use 'TTSUpdateSettingsFrame(voice=...)' instead.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
         logger.info(f"Switching TTS voice to: [{voice}]")
         if isinstance(self._settings, ServiceSettings):
             settings_cls = type(self._settings)