Get from zero to your first evaluated decision in five steps.
1

Create an account

Sign up at app.histeeria.com. Complete onboarding — you can skip agent setup initially and return later from the dashboard checklist.
2

Create an agent profile

In the app, go to Agents → Create profile. Give your agent a name, role, and description. This is how Histeeria understands what “good judgment” means for this agent.
3

Generate an API key

Open Settings → API keys and create a key. Copy it once — it is shown only at creation time. Link the key to your agent profile when prompted.
4

Install the SDK

pip install histeeria
5

Send your first decision

import os
from histeeria import Histeeria

client = Histeeria(api_key=os.environ["HISTEERIA_API_KEY"])

client.observe(
    input={"messages": [{"role": "user", "content": "Should I approve this refund?"}]},
    output="I'll verify the order status and policy before approving.",
    agent_id="support-bot",
)
client.flush()

​
Verify in the app

  1. Open Command center — you should see decision count increase.
  2. After the evaluation pipeline runs, open Monitoring or Evaluation for scores.
  3. Check Inbox for any incidents or alerts.
Your first decision appears within seconds. Evaluation scores typically follow once the agent reaches the warmup threshold (see Evaluation).

​
Environment variables

VariableRequiredDescription
HISTEERIA_API_KEYYesWorkspace API key from Settings
HISTEERIA_BASE_URLNoDefaults to https://api.histeeria.com

​
Next steps

SDK overview

Configuration, batching, and tracing.

Agent profiles

Define roles and link keys to agents.

Judgment dimensions

What each score means.

Production checklist

Ship safely to production.