pipecat integration

Author: kcui5

developer-guide/integrations/pipecat.mdx

@@ -0,0 +1,76 @@
+---
+title: "Pipecat"
+description: "Build voice AI agents with Fish Audio and Pipecat"
+icon: "/images/pipecat-logo.png"
+---
+
+[Pipecat](https://github.com/pipecat-ai/pipecat) is an open source framework for building voice and multimodal conversational AI. It handles the orchestration of audio, AI services, and conversation pipelines so you can focus on what makes your agent unique.
+
+Fish Audio integrates with Pipecat through `FishAudioTTSService`, which provides real-time text-to-speech synthesis using WebSocket streaming for low-latency conversational applications.
+
+## Prerequisites
+
+- A [Fish Audio account](https://fish.audio) with an API key
+- Python 3.9 or higher
+
+## Installation
+
+Install Pipecat with Fish Audio support:
+
+```bash
+pip install "pipecat-ai[fish]"
+```
+
+## Configuration
+
+Set your Fish Audio API key as an environment variable:
+
+```bash
+export FISH_API_KEY=your_api_key_here
+```
+
+## Basic usage
+
+Add `FishAudioTTSService` to your Pipecat pipeline:
+
+```python
+from pipecat.services.fish import FishAudioTTSService
+
+tts = FishAudioTTSService(
+    api_key=os.getenv("FISH_API_KEY"),
+    reference_id="your_voice_model_id",  # Optional: use a specific voice
+    model_id="speech-1.5",
+    params=FishAudioTTSService.InputParams(
+        latency="normal",
+        prosody_speed=1.0
+    )
+)
+```
+
+### Key parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `api_key` | Your Fish Audio API key |
+| `reference_id` | Voice model ID from the [Fish Audio library](https://fish.audio/discover) |
+| `model_id` | TTS model version (default: `speech-1.5`) |
+| `output_format` | Audio format: `pcm`, `mp3`, `wav`, or `opus` |
+
+### Prosody controls
+
+Customize speech characteristics with `InputParams`:
+
+```python
+params=FishAudioTTSService.InputParams(
+    latency="balanced",      # "normal" or "balanced"
+    prosody_speed=1.2,       # 0.5 to 2.0
+    prosody_volume=0,        # Volume adjustment in dB
+    normalize=True           # Audio normalization
+)
+```
+
+## Resources
+
+- [Pipecat Documentation](https://docs.pipecat.ai/server/services/tts/fish)
+- [Pipecat GitHub](https://github.com/pipecat-ai/pipecat)
+- [Fish Audio Voice Library](https://fish.audio/discovery)

docs.json

@@ -99,7 +99,9 @@
           },
           {
             "group": "Integrations",
-            "pages": []
+            "pages": [
+              "developer-guide/integrations/pipecat"
+            ]
           },
           {
             "group": "Best Practices",