Metadata-Version: 2.4
Name: forevr
Version: 0.1.3
Summary: Observability SDK for AI agents — auto-traces LangChain, CrewAI, OpenAI Agents, and any custom agent.
Author-email: Trace AI <mayankdindor229@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/traceai-dev/traceai
Project-URL: Repository, https://github.com/traceai-dev/traceai
Keywords: ai,agents,observability,tracing,langchain,crewai,openai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
Provides-Extra: crewai
Requires-Dist: crewai>=0.1.0; extra == "crewai"
Provides-Extra: openai
Requires-Dist: openai-agents>=0.1.0; extra == "openai"
Provides-Extra: all
Requires-Dist: langchain-core>=0.1.0; extra == "all"
Requires-Dist: crewai>=0.1.0; extra == "all"

# forevr

Observability SDK for AI agents. Auto-traces LangChain, CrewAI, OpenAI Agents, and any custom agent — with a full dashboard for latency, cost, errors, and LLM-as-judge scoring.

## Install

```bash
pip install forevr
```

## Quick start

```python
import forevr

forevr.init(
    api_key  = "tai-xxxxxxxxxxxxxxxxxxxx",
    project  = "my-agent",
)
```

## Integrations

**LangChain / LangGraph**
```python
from forevr.langchain import Tracer

agent = AgentExecutor(agent=..., tools=..., callbacks=[Tracer()])
```

**CrewAI**
```python
from forevr.crewai import trace_crew

result = trace_crew(crew, inputs={"topic": "AI trends"})
```

**OpenAI Agents SDK**
```python
from forevr.openai_agents import Processor
from agents import add_trace_processor

add_trace_processor(Processor())
```

**Any custom agent**
```python
from forevr.universal import Trace, span

with Trace("my_agent"):
    with span("tool_call", "web_search"):
        result = search(query)
```

## Local dev (no API key needed)

Run the backend locally and traces appear in the dashboard automatically:

```python
# No init() needed — defaults to http://127.0.0.1:8000
from forevr.langchain import Tracer
```

## Environment variables

```bash
export FOREVR_API_KEY=tai-xxxxxxxxxxxxxxxxxxxx
export FOREVR_PROJECT=my-agent
```
