Option A — Agent Lab (recommended)

For local agent development you need Ollama and a running AITracer instance.

Ollama

curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.2
ollama serve

AITracer (development)

git clone https://github.com/no1rstack/aitracer.git
cd aitracer
npm install

Configure DATABASE_URL and secrets (see Environment Configuration), then:

infisical run -- npm run dev

Continue with Quick Start.

Option B — SDK / API ingestion

For production apps that send traces to AITracer over HTTP:

Install the SDK

pip install aitracer-sdk
# or
npm install @noirstack/aitracer-sdk

Configure authentication

export AITRACER_API_KEY="your-api-key"
export AITRACER_BASE_URL="https://your-aitracer-host"

Create API keys in Dashboard → Settings.

Send a trace

from aitracer import AITracer
 
client = AITracer(api_key="your-api-key")
 
trace = client.trace(
    model="gpt-4o",
    input="Summarize this report",
    metadata={"workflow": "finance-review"},
)
 
print(trace.id)

See Trace Ingestion API for the raw HTTP contract.

Self-hosted deployment

For production installs (Postgres, Traefik, Infisical):

Environment variables (Agent Lab)

Variable	Purpose
`OLLAMA_BASE_URL`	Ollama HTTP API (default `http://127.0.0.1:11434`)
`DATABASE_URL`	PostgreSQL connection for traces
`DEV_AUTH_BYPASS`	Local dev only — skip Auth0

First Trace API Authentication