Fix docs generation build issues

docs/api/README.md

@@ -7,7 +7,7 @@ This directory contains the source files for auto-generating Pipecat's server AP
 1. Install documentation dependencies:
 
 ```bash
-pip install -r requirements-base.txt requirements-playht.txt requirements-riva.txt
+pip install -r requirements.txt
 ```
 
 2. Make the build scripts executable:

docs/api/conf.py

@@ -44,7 +44,12 @@ autodoc_default_options = {
 autodoc_mock_imports = [
     "riva",
     "livekit",
-    "pyht",
+    "pyht",  # Base PlayHT package
+    "pyht.async_client",  # PlayHT specific imports
+    "pyht.client",
+    "pyht.protos",
+    "pyht.protos.api_pb2",
+    "pipecat_ai_playht",  # PlayHT wrapper
     "anthropic",
     "assemblyai",
     "boto3",
@@ -63,13 +68,14 @@ autodoc_mock_imports = [
     "openpipe",
     "simli",
     "soundfile",
-    # Add these new mocks
+    # Existing mocks
+    "pipecat_ai_krisp",
     "pyaudio",
     "_tkinter",
     "tkinter",
     "daily",
     "daily_python",
-    "pydantic.BaseModel",  # Mock base pydantic to avoid model conflicts
+    "pydantic.BaseModel",
     "pydantic.Field",
     "pydantic._internal._model_construction",
     "pydantic._internal._fields",

docs/api/requirements-playht.txt

@@ -1,3 +0,0 @@
-# Force specific grpcio version for PlayHT
-grpcio>=1.68.0
-pipecat-ai[playht]

docs/api/requirements-riva.txt

@@ -1,3 +0,0 @@
-# Force specific grpcio version for Riva
-grpcio==1.65.4
-pipecat-ai[riva]

docs/api/requirements.txt

@@ -21,7 +21,7 @@ pipecat-ai[gladia]
 pipecat-ai[google]
 pipecat-ai[grok]
 pipecat-ai[groq]
-pipecat-ai[krisp]
+# pipecat-ai[krisp] # Mocked instead
 pipecat-ai[langchain]
 pipecat-ai[livekit]
 pipecat-ai[lmnt]
@@ -30,7 +30,9 @@ pipecat-ai[moondream]
 pipecat-ai[nim]
 pipecat-ai[noisereduce]
 pipecat-ai[openai]
-pipecat-ai[openpipe]
+# pipecat-ai[openpipe]
+# pipecat-ai[playht] # Mocked due to grpcio conflict with riva
+pipecat-ai[riva]
 pipecat-ai[silero]
 pipecat-ai[simli]
 pipecat-ai[soundfile]

docs/api/rtd-test.sh

@@ -10,20 +10,15 @@ echo "Creating test directory: $TEST_DIR"
 mkdir -p "$TEST_DIR"
 cd "$TEST_DIR"
 
-# Create single virtual environment
+# Create virtual environment
 python -m venv venv
 source venv/bin/activate
 
-echo "Installing base dependencies..."
+echo "Installing build dependencies..."
 pip install --upgrade pip wheel setuptools
-pip install -r "$DOCS_DIR/requirements-base.txt"
 
-# Try to install optional dependencies, but don't fail if they don't work
-echo "Installing Riva dependencies..."
-pip install -r "$DOCS_DIR/requirements-riva.txt" || echo "Failed to install Riva dependencies"
-
-echo "Installing PlayHT dependencies..."
-pip install -r "$DOCS_DIR/requirements-playht.txt" || echo "Failed to install PlayHT dependencies"
+echo "Installing documentation dependencies..."
+pip install -r "$DOCS_DIR/requirements.txt"
 
 echo "Building documentation..."
 cd "$DOCS_DIR"
@@ -31,6 +26,13 @@ sphinx-build -b html . "_build/html"
 
 echo "Build complete. Check _build/html directory for output."
 
+# Print summary
+echo -e "\n=== Build Summary ==="
+echo "Documentation: $DOCS_DIR/_build/html"
+echo "Test environment: $TEST_DIR"
+echo -e "\nTo view the documentation:"
+echo "open $DOCS_DIR/_build/html/index.html"
+
 # Print installed packages for verification
-echo "Installed packages:"
-pip freeze
+echo -e "\n=== Installed Packages ==="
+pip freeze | grep -E "sphinx|pipecat"