Metadata-Version: 2.4
Name: agent-instrumentation
Version: 1.0.1
Summary: Automatic instrumentation for Python applications using Traceloop SDK
Author-email: Hansi Karunarathna <hansijayanika@gmail.com>
Maintainer-email: Hansi Karunarathna <hansijayanika@gmail.com>
License: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: traceloop-sdk>=0.47.0
Description-Content-Type: text/markdown

# Agent Instrumentation

Automatic OpenTelemetry instrumentation for Python agents using the Traceloop SDK, with trace visibility.

## Overview

`agent-instrumentation` enables zero-code instrumentation for Python agents, automatically capturing traces for LLM calls, API requests, and other operations. It seamlessly wraps your agent’s execution with OpenTelemetry tracing powered by the Traceloop SDK.

## Features

- **Zero Code Changes**: Instrument existing applications without modifying code
- **Automatic Tracing**: Traces LLM calls, HTTP requests, database queries, and more
- **OpenTelemetry Compatible**: Uses industry-standard OpenTelemetry protocol
- **Flexible Configuration**: Configure via environment variables
- **Framework Agnostic**: Works with any Python application or framework

## Installation

```bash
pip install -i agent-instrumentation
```

## Quick Start

### 1. Set Required Environment Variables

```bash
export AMP_APP_NAME="my-application"
export AMP_OTEL_EXPORTER_OTLP_ENDPOINT="https://your-otel-endpoint.com"
export AMP_API_KEY="your-api-key"
```

### 2. Run Your Application

Use the `agent-trace` command to wrap your application:

```bash
# Run a Python script
agent-trace python my_script.py

# Run with uvicorn
agent-trace uvicorn app:main --reload

# Run with any package manager
agent-trace poetry run python script.py
agent-trace uv run python script.py
```

That's it! Your application is now instrumented and sending traces to your configured endpoint.
