Metadata-Version: 2.4
Name: agentlens-observe
Version: 0.3.0
Summary: Debug AI agents visually — self-hosted, open-source observability SDK
Project-URL: Homepage, https://github.com/tranhoangtu-it/agentlens
Project-URL: Repository, https://github.com/tranhoangtu-it/agentlens
Project-URL: Issues, https://github.com/tranhoangtu-it/agentlens/issues
Author: AgentLens Contributors
License: MIT
Keywords: agents,ai,debugging,llm,observability,tracing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Debuggers
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Provides-Extra: all
Requires-Dist: autogen-agentchat>=0.4; extra == 'all'
Requires-Dist: crewai>=0.51; extra == 'all'
Requires-Dist: google-adk>=0.3; extra == 'all'
Requires-Dist: langchain-core>=0.2; extra == 'all'
Requires-Dist: llama-index-core>=0.11; extra == 'all'
Requires-Dist: opentelemetry-api>=1.20; extra == 'all'
Requires-Dist: opentelemetry-sdk>=1.20; extra == 'all'
Provides-Extra: autogen
Requires-Dist: autogen-agentchat>=0.4; extra == 'autogen'
Provides-Extra: crewai
Requires-Dist: crewai>=0.51; extra == 'crewai'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Provides-Extra: google-adk
Requires-Dist: google-adk>=0.3; extra == 'google-adk'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.2; extra == 'langchain'
Provides-Extra: llamaindex
Requires-Dist: llama-index-core>=0.11; extra == 'llamaindex'
Provides-Extra: otel
Requires-Dist: opentelemetry-api>=1.20; extra == 'otel'
Requires-Dist: opentelemetry-sdk>=1.20; extra == 'otel'
Description-Content-Type: text/markdown

# agentlens-observe

**Debug AI agents visually** — Python SDK for [AgentLens](https://github.com/tranhoangtu-it/agentlens), the self-hosted AI agent observability platform.

## Install

```bash
pip install agentlens-observe
```

## Quick Start

```python
import agentlens

agentlens.configure(server_url="http://localhost:8000")

@agentlens.trace(name="ResearchAgent")
def run_agent(query: str) -> str:
    with agentlens.span("web_search", "tool_call") as s:
        result = search(query)
        s.set_output(result)
        s.set_cost("gpt-4o", input_tokens=500, output_tokens=200)
    return summarize(result)

run_agent("Latest AI research papers")
# → Traces stream to your AgentLens dashboard
```

## Features

- **2-line integration** — `@agentlens.trace` decorator + `agentlens.span()` context manager
- **Fire-and-forget** — never blocks your agent (daemon thread transport)
- **Async-safe** — uses `contextvars.ContextVar` for trace propagation
- **Cost tracking** — built-in pricing for 12+ models (GPT-4o, Claude, etc.)
- **Framework integrations** — LangChain, CrewAI

## Framework Integrations

### LangChain / LangGraph

```python
from agentlens.integrations.langchain import AgentLensCallbackHandler
agent.run("task", callbacks=[AgentLensCallbackHandler()])
```

### CrewAI

```python
from agentlens.integrations.crewai import patch_crewai
patch_crewai()  # Auto-instruments all Crew runs
```

## License

MIT — see [LICENSE](https://github.com/tranhoangtu-it/agentlens/blob/main/LICENSE)
