traceagent 0.1.0

Local-first observability for AI agents. Lightweight SDK — trace LangChain, LangGraph, and any Python code.

AgentLens SDK

Local-first observability for AI agents. Lightweight Python SDK — trace LangChain, LangGraph, and any Python code.

Install

pip install agentlens

Quick Start

Option 1: Environment Variables (zero code changes, like LangSmith)

export AGENTLENS_ENABLED=true
export AGENTLENS_ENDPOINT=http://localhost:6832   # your AgentLens server

import agentlens  # auto-traces all LangChain/LangGraph calls

result = graph.invoke({"messages": [HumanMessage(content="Hello!")]})

Option 2: Explicit Callback

from agentlens import AgentLens

lens = AgentLens(server_url="http://localhost:6832")

result = graph.invoke(
    {"messages": [HumanMessage(content="Hello!")]},
    config={"callbacks": [lens.callback()]}
)

Option 3: Decorators & Context Managers

from agentlens import AgentLens

lens = AgentLens()

@lens.observe(name="search", kind="tool")
def search(query: str):
    return results

with lens.trace("My Pipeline") as t:
    result = search("hello")
    t.outputs = {"result": result}

Configuration

Env Variable	Description	Default
AGENTLENS_ENABLED	Enable tracing	false
AGENTLENS_ENDPOINT	Server URL	http://localhost:6832
AGENTLENS_PROJECT	Project name	default
AGENTLENS_TAGS	Comma-separated tags
AGENTLENS_AUTO_TRACE	Auto-attach to LangChain	true when enabled

Server

The SDK sends traces to an AgentLens server. See agentlens-server for setup.