Skip to main content

​
Install the SDK

The Aden SDK has zero required dependencies. Install optional provider support as needed.

​
Basic Installation

pip install aden

​
With Provider Support

pip install aden[openai]

​
Framework Integrations

pip install aden[pydantic-ai]

​
Database Backends

pip install aden[timescale]

​
Development

pip install aden[dev]

​
Requirements

RequirementVersion
Python>= 3.10

​
Optional Dependencies

PackageVersionRequired For
openai>= 1.0.0OpenAI provider
tiktoken>= 0.5.0OpenAI token counting
anthropic>= 0.20.0Anthropic provider
google-generativeai>= 0.4.0Gemini provider

​
Verify Installation

Create a simple test file: 
from aden import instrument, MeterOptions, create_console_emitter, uninstrument, get_instrumented_sdks

# Instrument the SDK
instrument(MeterOptions(
    emit_metric=create_console_emitter(pretty=True),
))

result = get_instrumented_sdks()
print(f"Instrumented: {result}")
# Output: InstrumentationResult(openai=True, anthropic=False, gemini=False)

# Clean up
uninstrument()
Run the test: 
python test.py

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows
pip install aden[all]

​
Type Checking

The SDK includes type annotations. For type checking with mypy: 
# pyproject.toml
[tool.mypy]
python_version = "3.10"
strict = true

mypy your_code.py

​
Next Steps

Quick Start

Learn how to instrument your first LLM application