feat: add Speechify TTS extension

Author: luke-speechify

ai_agents/agents/ten_packages/extension/speechify_tts_python/README.md

@@ -0,0 +1,67 @@
+# Speechify TTS Python Extension
+
+A Text-to-Speech extension for TEN Framework using the [Speechify](https://speechify.ai) API.
+
+## Features
+
+- Real-time text-to-speech synthesis via Speechify's `simba-3.2` streaming-native model
+- HTTP chunked audio streaming (`POST /v1/audio/stream`) for low-latency playback
+- Immediate cancellation support for flush/interrupt scenarios
+- Configurable audio parameters (sample rate, language, loudness/text normalization)
+- Audio dump functionality for debugging
+
+## Architecture
+
+Unlike ElevenLabs' persistent bidirectional websocket, Speechify's public API is a
+one-shot HTTP request/response stream: each TTS request buffers incoming text deltas
+until `text_input_end`, then issues a single `POST /v1/audio/stream` call whose
+chunked response is forwarded to TEN as they arrive. The `speechify-api` Python SDK
+(`AsyncSpeechify`) is used for all outbound calls, with `Speechify-Caller: ten-framework`
+set on every request so usage is attributed to this integration.
+
+## API
+
+Refer to the `api` definition in [manifest.json](manifest.json) and default values in
+[property.json](property.json).
+
+## Development
+
+### Build
+
+Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+### Unit test
+
+Run tests using pytest:
+```bash
+pytest tests/
+```
+
+## Configuration
+
+Configure the extension in `property.json`:
+
+```json
+{
+  "params": {
+    "base_url": "https://api.speechify.ai",
+    "key": "your_speechify_api_key",
+    "model": "simba-3.2",
+    "voice_id": "george",
+    "sample_rate": 24000
+  }
+}
+```
+
+`key` and `voice_id` are required. `base_url` defaults to the public Speechify API and
+should not normally be overridden. `model` defaults to `simba-3.2`, the recommended
+streaming-native Simba 3 model.
+
+## Documentation
+
+- [API Reference](manifest.json) - Complete API specification
+- [Configuration](property.json) - Default configuration values
+- [Speechify API docs](https://docs.speechify.ai)

ai_agents/agents/ten_packages/extension/speechify_tts_python/__init__.py

@@ -0,0 +1,6 @@
+#
+# This file is part of TEN Framework, an open source project.
+# Licensed under the Apache License, Version 2.0.
+# See the LICENSE file for more information.
+#
+from . import addon

ai_agents/agents/ten_packages/extension/speechify_tts_python/addon.py

@@ -0,0 +1,20 @@
+#
+# This file is part of TEN Framework, an open source project.
+# Licensed under the Apache License, Version 2.0.
+# See the LICENSE file for more information.
+#
+from ten_runtime import (
+    Addon,
+    register_addon_as_extension,
+    TenEnv,
+)
+
+
+@register_addon_as_extension("speechify_tts_python")
+class SpeechifyTTSExtensionAddon(Addon):
+
+    def on_create_instance(self, ten_env: TenEnv, name: str, context) -> None:
+        from .extension import SpeechifyTTSExtension
+
+        ten_env.log_info("SpeechifyTTSExtensionAddon on_create_instance")
+        ten_env.on_create_instance_done(SpeechifyTTSExtension(name), context)

ai_agents/agents/ten_packages/extension/speechify_tts_python/config.py

@@ -0,0 +1,35 @@
+from typing import Any, Dict, List
+from pydantic import BaseModel
+from ten_ai_base import utils
+
+
+class SpeechifyTTSConfig(BaseModel):
+    dump: bool = False
+    dump_path: str = "./"
+    params: Dict[str, Any] = {}
+    black_list_keys: List[str] = []
+
+    # query params
+    sample_rate: int = 24000
+
+    def to_str(self, sensitive_handling: bool = False) -> str:
+        if not sensitive_handling:
+            return f"{self}"
+
+        config = self.copy(deep=True)
+        if config.params.get("key"):
+            config.params["key"] = utils.encrypt(config.params["key"])
+        return f"{config}"
+
+    def update_params(self) -> None:
+        # This function allows overriding default config values with 'params' from property.json
+        # pylint: disable=no-member
+
+        for key, value in self.params.items():
+            if hasattr(self, key):
+                setattr(self, key, value)
+
+        # Delete keys after iteration is complete
+        for key in self.black_list_keys:
+            if key in self.params:
+                del self.params[key]