Installation Guide¶

Quick Installation¶

1. Install Core Dependencies¶

cd projects/week4/collaboration-tools

# Upgrade pip first
pip install --upgrade pip

# Install with correct versions
pip install --upgrade pydantic>=2.8.0 pydantic-settings>=2.4.0 anyio>=4.5.0
pip install -r requirements.txt

2. Install Browser Dependencies¶

# Install Playwright browsers
playwright install chromium

3. Configure Environment¶

# Copy example configuration
cp env.example .env

# Edit .env with your credentials
# At minimum, set OPENAI_API_KEY for browser AI tasks
nano .env  # or use your preferred editor

4. Verify Installation¶

# Run basic tests
python test_basic.py

# Or run the quickstart demo
python quickstart.py

Troubleshooting¶

Issue: Pydantic Import Errors¶

Error: ModuleNotFoundError: No module named 'pydantic._internal._signature'

Solution:

pip install --upgrade pydantic>=2.8.0 pydantic-settings>=2.4.0

Issue: anyio Type Errors¶

Error: TypeError: 'function' object is not subscriptable

Solution:

pip install --upgrade anyio>=4.5.0

Issue: Browser Errors¶

Error: Browser fails to start or Playwright not found

Solution:

playwright install chromium --force

Issue: MCP Server Won't Start¶

Solution:

# Clean install
pip uninstall mcp fastmcp pydantic pydantic-settings anyio -y
pip install -r requirements.txt