xml-pipeline/docs/wiki/Installation.md
dullfig 515c738abb Add wiki documentation for xml-pipeline.org
Comprehensive documentation set for XWiki:
- Home, Installation, Quick Start guides
- Writing Handlers and LLM Router guides
- Architecture docs (Overview, Message Pump, Thread Registry, Shared Backend)
- Reference docs (Configuration, Handler Contract, CLI)
- Hello World tutorial
- Why XML rationale
- Pandoc conversion scripts (bash + PowerShell)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 20:40:47 -08:00

1.6 KiB

Installation

Requirements

  • Python 3.11 or higher
  • pip, uv, or pipx

Install from PyPI

pip install xml-pipeline

Install with Optional Features

xml-pipeline has optional dependencies for different use cases:

# Core only (minimal)
pip install xml-pipeline

# With Anthropic Claude support
pip install xml-pipeline[anthropic]

# With OpenAI support
pip install xml-pipeline[openai]

# With Redis for distributed deployments
pip install xml-pipeline[redis]

# With web search capability
pip install xml-pipeline[search]

# With interactive console (for examples)
pip install xml-pipeline[console]

# Everything
pip install xml-pipeline[all]

# Development (includes testing tools)
pip install xml-pipeline[dev]

Install from Source

# Clone the repository
git clone https://github.com/xml-pipeline/xml-pipeline.git
cd xml-pipeline

# Create virtual environment
python -m venv .venv

# Activate (Windows)
.venv\Scripts\activate

# Activate (Linux/macOS)
source .venv/bin/activate

# Install in development mode
pip install -e ".[all]"

Verify Installation

# Check version
xml-pipeline version

# Or use the short alias
xp version

Expected output:

xml-pipeline 0.4.0
Python 3.11.x
Features: anthropic, console, redis, search

Environment Variables

Create a .env file in your project root for API keys:

# LLM Provider Keys (add the ones you need)
XAI_API_KEY=xai-...
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...

The library automatically loads .env files via python-dotenv.

Next Steps