Merge pull request #29 from roryeckel/copilot/fix-28

Add Chatterbox TTS Docker Compose example integration

Author: roryeckel

README.md

@@ -252,7 +252,28 @@ For users who want high-quality text-to-speech without API costs, Microsoft Edge
   docker compose -f docker-compose.openai-edge-tts.yml up -d
   ```
 
-#### 6. Development with Docker
+#### 6. Deploying with Chatterbox TTS
+
+For users who want high-quality local text-to-speech with voice cloning capabilities, Chatterbox TTS provides an OpenAI-compatible API with advanced voice cloning features. This setup runs completely locally and supports custom voice training.
+
+- **Chatterbox TTS Setup**:
+  - Local OpenAI-compatible text-to-speech API with voice cloning capabilities
+  - Supports custom voice samples for personalized speech generation
+  - Advanced voice library management with persistent storage
+  - FastAPI-powered with real-time status monitoring and streaming support
+  - GPU acceleration support for faster processing
+  - No external API dependencies - runs completely offline
+  - [Learn more about Chatterbox TTS API](https://github.com/travisvn/chatterbox-tts-api)
+
+- **Docker Compose Configuration**: Use the `docker-compose.chatterbox.yml` template which includes configuration for both the Wyoming OpenAI proxy and Chatterbox TTS service.
+
+- **Command**:
+  
+  ```bash
+  docker compose -f docker-compose.chatterbox.yml up -d
+  ```
+
+#### 7. Development with Docker
 
 If you are developing the Wyoming OpenAI proxy server and want to build it from source, use the `docker-compose.dev.yml` file along with the base configuration.
 
@@ -262,17 +283,17 @@ If you are developing the Wyoming OpenAI proxy server and want to build it from
   docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d --build
   ```
 
-#### 7. Example: Development with Additional Local Service
+#### 8. Example: Development with Additional Local Service
 
-For a development setup using the Speaches local service, combine `docker-compose.speaches.yml` and `docker-compose.dev.yml`. This also works for `docker-compose.kokoro-fastapi.yml`, `docker-compose.localai.yml`, and `docker-compose.openai-edge-tts.yml`.
+For a development setup using the Speaches local service, combine `docker-compose.speaches.yml` and `docker-compose.dev.yml`. This also works for `docker-compose.kokoro-fastapi.yml`, `docker-compose.localai.yml`, `docker-compose.openai-edge-tts.yml`, and `docker-compose.chatterbox.yml`.
 
 - **Command**:
 
   ```bash
   docker compose -f docker-compose.speaches.yml -f docker-compose.dev.yml up -d --build
   ```
 
-#### 8. Docker Tags
+#### 9. Docker Tags
 
 We follow specific tagging conventions for our Docker images. These tags help in identifying the version and branch of the code that a particular Docker image is based on.
 
@@ -286,7 +307,7 @@ We follow specific tagging conventions for our Docker images. These tags help in
 
 - **`pr-{number}`**: Pull request tags (e.g., `pr-123`) are automatically created for each pull request to allow testing of proposed changes before they are merged. These tags are automatically cleaned up when the pull request is closed or merged.
 
-#### 9. Pull Request Docker Images
+#### 10. Pull Request Docker Images
 
 For contributors and maintainers who want to test changes from pull requests before they are merged, we automatically build and push Docker images for each pull request.
 

docker-compose.chatterbox.yml

@@ -0,0 +1,66 @@
+services:
+  wyoming_openai:
+    image: ghcr.io/roryeckel/wyoming_openai:latest
+    container_name: wyoming_openai
+    ports:
+      - "10300:10300"
+    restart: unless-stopped
+    environment:
+      WYOMING_URI: tcp://0.0.0.0:10300
+      WYOMING_LOG_LEVEL: INFO
+      WYOMING_LANGUAGES: en
+      TTS_OPENAI_URL: http://chatterbox-tts:4123/v1
+      TTS_MODELS: "tts-1-hd"
+      TTS_BACKEND: "OPENAI"
+      TTS_VOICES: "default"
+      TTS_SPEED: "1.0"
+    depends_on:
+      chatterbox-tts:
+        condition: service_healthy
+
+  chatterbox-tts:
+    image: travisvn/chatterbox-tts-api:latest
+    container_name: chatterbox-tts
+    restart: unless-stopped
+    ports:
+      - "4123:4123"
+    environment:
+      # API Configuration
+      - PORT=4123
+      - HOST=0.0.0.0
+
+      # TTS Model Settings
+      - EXAGGERATION=0.5
+      - CFG_WEIGHT=0.5
+      - TEMPERATURE=0.8
+
+      # Text Processing
+      - MAX_CHUNK_LENGTH=280
+      - MAX_TOTAL_LENGTH=3000
+
+      # Voice and Model Settings
+      # - VOICE_SAMPLE_PATH=/app/voice-sample.mp3
+      - DEVICE=auto
+      - MODEL_CACHE_DIR=/cache
+      # - VOICE_LIBRARY_DIR=/voices
+
+      # Memory Settings
+      - MEMORY_CLEANUP_INTERVAL=5
+      - CUDA_CACHE_CLEAR_INTERVAL=3
+      - ENABLE_MEMORY_MONITORING=true
+    volumes:
+      # Mount model cache for persistence
+      - chatterbox-models:/cache
+
+      # Mount voice library for persistence
+      # - chatterbox-voices:/voices
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:4123/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 120s
+
+volumes:
+  chatterbox-models:
+  # chatterbox-voices: