Quickstart

curl -sSL https://raw.githubusercontent.com/AgentX-ai/AgentX-trace-eval/main/install.sh | bash
export PATH="$HOME/.agentx/bin:$PATH"   # the installer prints this line but doesn't apply it
agentx-server --dev

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

git clone https://github.com/AgentX-ai/AgentX-trace-eval.git && cd AgentX-trace-eval
docker build -t agentx-selfhost .
docker run -d -p 4700:4700 -v agentx-data:/data agentx-selfhost
docker logs $(docker ps -lq) 2>&1 | grep "API key"   # the key your SDK will use

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)