ai-agent-book/chapter4/collaboration-tools/INSTALL.md

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