Installation

Requirements

• Python >= 3.13
• pip or uv

Install from PyPI

pip install agentharnessapi

Install from Source (development)

git clone https://github.com/shibuiwilliam/AgenticAPI.git
cd AgenticAPI
pip install -e ".[dev]"

Or with uv:

uv sync --group dev

Dependencies

AgenticAPI installs the following core dependencies:

Package	Version	Purpose
starlette	>= 1.0	ASGI foundation
pydantic	>= 2.12	Validation and schemas
structlog	>= 25.0	Structured logging
httpx	>= 0.28	Async HTTP client
anthropic	>= 0.89	Claude API
openai	>= 2.30	OpenAI API
google-genai	>= 1.70	Gemini API
python-multipart	>= 0.0.20	File upload parsing

Optional Dependencies

# MCP support (lightweight optional extra)
pip install agentharnessapi[mcp]

# OpenTelemetry tracing (no-op unless installed)
pip install opentelemetry-api opentelemetry-sdk opentelemetry-exporter-otlp

# Prometheus metrics via OpenTelemetry
pip install opentelemetry-api opentelemetry-sdk prometheus-client

The observability layer is designed to degrade gracefully: configure_tracing() and configure_metrics() silently no-op if these packages aren't installed. See the Observability guide for details.

Extensions

Heavyweight integrations are released as separate packages:

# Claude Agent SDK (full agentic loop with policies and audit)
pip install agentharnessapi[claude-agent-sdk]

See the Extensions guide for the full list and how to build your own.

Verify Installation

python -c "import agenticapi; print(agenticapi.__version__)"