Quickstart

curl -sSL https://raw.githubusercontent.com/AgentX-ai/AgentX-Trace-Eval/main/install.sh | bash
agentx-server --dev

pip install agentx-python
agentx-trace-eval --dev

docker run -d -p 4700:4700 -v agentx-data:/data \
  ghcr.io/agentx-ai/agentx-selfhost   # or build from the repo's Dockerfile
docker logs <container>               # the API key is printed here

from agentx import AgentX

client = AgentX.from_env()

@client.tracer.trace("my-agent")
def answer(query: str) -> str:
    # your agent logic - args become the input, the return value the output
    return run_my_agent(query)

answer("How do I reset my password?")
client.tracer.flush(timeout=10)  # send queued traces before a short script exits

from agentx import AgentX

client = AgentX.from_env()

query = "How do I reset my password?"
with client.tracer.trace("my-agent", input={"query": query}, model="gpt-4o-mini") as span:
    answer = run_my_agent(query)
    span.output = answer

client.tracer.flush(timeout=10)