Installation¶

Basic Installation¶

pip install genai-otel-instrument

This installs the core library with OpenTelemetry SDK and basic instrumentation support.

Multimodal extras (v1.0.0)¶

# Everything for multimodal capture (Pillow + pypdf + opencv + boto3)
pip install 'genai-otel-instrument[multimodal]'

# Pick-and-mix
pip install 'genai-otel-instrument[multimodal-images]'   # Pillow (EXIF stripping)
pip install 'genai-otel-instrument[multimodal-pdf]'      # pypdf (PDF redaction)
pip install 'genai-otel-instrument[multimodal-faces]'    # opencv (face blur)
pip install 'genai-otel-instrument[multimodal-s3]'       # boto3 (S3/MinIO offload)

See the Multimodal Observability guide for capture-mode configuration and the redactor / store backends.

Optional Extras¶

Install additional capabilities as needed:

LLM Providers¶

# Individual providers
pip install genai-otel-instrument[openai]
pip install genai-otel-instrument[anthropic]
pip install genai-otel-instrument[google]
pip install genai-otel-instrument[aws]
pip install genai-otel-instrument[cohere]
pip install genai-otel-instrument[mistral]
pip install genai-otel-instrument[groq]
pip install genai-otel-instrument[ollama]
pip install genai-otel-instrument[together]
pip install genai-otel-instrument[cometapi]

# All providers
pip install genai-otel-instrument[all-providers]

Frameworks¶

pip install genai-otel-instrument[crewai]
pip install genai-otel-instrument[langchain]
pip install genai-otel-instrument[langgraph]
pip install genai-otel-instrument[google-adk]
pip install genai-otel-instrument[autogen-agentchat]

OpenInference (Python 3.10+)¶

pip install genai-otel-instrument[openinference]

Includes LiteLLM, Smolagents, and MCP instrumentation via OpenInference.

GPU Metrics¶

pip install genai-otel-instrument[gpu]       # NVIDIA only
pip install genai-otel-instrument[amd-gpu]   # AMD only
pip install genai-otel-instrument[all-gpu]   # Both

Databases and MCP Tools¶

pip install genai-otel-instrument[databases]    # PostgreSQL, MySQL, MongoDB, Redis, etc.
pip install genai-otel-instrument[messaging]    # Kafka, RabbitMQ
pip install genai-otel-instrument[vector-dbs]   # Pinecone, Weaviate, Qdrant, ChromaDB, etc.
pip install genai-otel-instrument[all-mcp]      # All MCP tools

Evaluation Features¶

pip install genai-otel-instrument[evaluation]   # PII, toxicity, bias detection

Everything¶

pip install genai-otel-instrument[all]

Development Installation¶

git clone https://github.com/Mandark-droid/genai_otel_instrument.git
cd genai_otel_instrument
pip install -e ".[dev,all]"

Requirements¶

Python 3.9+
OpenTelemetry SDK 1.20.0+
OpenInference features require Python 3.10+