More fixes for missing packages

docs/api/conf.py

@@ -40,6 +40,31 @@ autodoc_default_options = {
     "show-inheritance": True,
 }
 
+# Mock imports for optional dependencies
+autodoc_mock_imports = [
+    "riva",
+    "livekit",
+    "pyht",
+    "anthropic",
+    "assemblyai",
+    "boto3",
+    "azure",
+    "cartesia",
+    "deepgram",
+    "elevenlabs",
+    "fal",
+    "gladia",
+    "google",
+    "krisp",
+    "langchain",
+    "lmnt",
+    "noisereduce",
+    "openai",
+    "openpipe",
+    "simli",
+    "soundfile",
+]
+
 # HTML output settings
 html_theme = "sphinx_rtd_theme"
 html_static_path = ["_static"]
@@ -47,6 +72,39 @@ autodoc_typehints = "description"
 html_show_sphinx = False
 
 
+def verify_modules():
+    """Verify that required modules are available."""
+    required_modules = {
+        "services": [
+            "assemblyai",
+            "aws",
+            "cartesia",
+            "deepgram",
+            "google",
+            "lmnt",
+            "riva",
+            "simli",
+        ],
+        "serializers": ["livekit"],
+        "vad": ["silero", "vad_analyzer"],
+    }
+
+    missing = []
+    for category, modules in required_modules.items():
+        for module in modules:
+            try:
+                __import__(f"pipecat.{category}.{module}")
+                logger.info(f"Successfully imported pipecat.{category}.{module}")
+            except ImportError as e:
+                missing.append(f"pipecat.{category}.{module}")
+                logger.warning(
+                    f"Optional module not available: pipecat.{category}.{module} - {str(e)}"
+                )
+
+    if missing:
+        logger.warning(f"Some optional modules are not available: {missing}")
+
+
 def clean_title(title: str) -> str:
     """Automatically clean module titles."""
     # Remove everything after space (like 'module', 'processor', etc.)
@@ -151,3 +209,7 @@ def setup(app):
 
     except Exception as e:
         logger.error(f"Error generating API documentation: {e}", exc_info=True)
+
+
+# Run module verification
+verify_modules()

docs/api/index.rst

@@ -22,6 +22,7 @@ Core Components
 * :mod:`Frames <pipecat.frames>`
 * :mod:`Processors <pipecat.processors>`
 * :mod:`Pipeline <pipecat.pipeline>`
+* :mod:`Services <pipecat.services>`
 
 Audio Processing
 ~~~~~~~~~~~~~~~~

docs/api/requirements-base.txt

@@ -0,0 +1,36 @@
+# Sphinx dependencies
+sphinx>=8.1.3
+sphinx-rtd-theme
+sphinx-markdown-builder
+sphinx-autodoc-typehints
+toml
+
+# Install all extras individually to ensure they're properly resolved
+pipecat-ai[anthropic]
+pipecat-ai[assemblyai]
+pipecat-ai[aws]
+pipecat-ai[azure]
+pipecat-ai[canonical]
+pipecat-ai[cartesia]
+pipecat-ai[deepgram]
+pipecat-ai[elevenlabs]
+pipecat-ai[fal]
+pipecat-ai[fireworks]
+pipecat-ai[gladia]
+pipecat-ai[google]
+pipecat-ai[grok]
+pipecat-ai[groq]
+pipecat-ai[krisp]
+pipecat-ai[langchain]
+pipecat-ai[livekit]
+pipecat-ai[lmnt]
+pipecat-ai[moondream]
+pipecat-ai[nim]
+pipecat-ai[noisereduce]
+pipecat-ai[openai]
+pipecat-ai[openpipe]
+pipecat-ai[silero]
+pipecat-ai[simli]
+pipecat-ai[soundfile]
+pipecat-ai[websocket]
+pipecat-ai[whisper]

docs/api/requirements-playht.txt

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

docs/api/requirements-riva.txt

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

docs/api/requirements.txt

@@ -1,6 +0,0 @@
-sphinx>=8.1.3
-sphinx-rtd-theme
-sphinx-markdown-builder
-sphinx-autodoc-typehints
-toml
-pipecat-ai[anthropic,assemblyai,aws,azure,canonical,cartesia,deepgram,elevenlabs,fal,fireworks,gladia,google,grok,groq,krisp,langchain,lmnt,moondream,nim,noisereduce,openai,openpipe,playht,riva,silero,simli,soundfile,websocket,whisper]

docs/api/rtd-test.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+set -e
+
+# Configuration
+DOCS_DIR=$(pwd)
+PROJECT_ROOT=$(cd ../../ && pwd)
+TEST_DIR="/tmp/rtd-test-$(date +%Y%m%d_%H%M%S)"
+
+echo "Creating test directory: $TEST_DIR"
+mkdir -p "$TEST_DIR"
+cd "$TEST_DIR"
+
+# Create single virtual environment
+python -m venv venv
+source venv/bin/activate
+
+echo "Installing base 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 "Building documentation..."
+cd "$DOCS_DIR"
+sphinx-build -b html . "_build/html"
+
+echo "Build complete. Check _build/html directory for output."
+
+# Print installed packages for verification
+echo "Installed packages:"
+pip freeze