Packages
| Language | Install | Import |
|---|---|---|
| Python 3.8+ | pip install histeeria | from histeeria import Histeeria |
| Node 18+ / TS | npm install histeeria | import { Histeeria } from "histeeria" |
Core API
Every SDK exposes:| Method | Purpose |
|---|---|
observe(...) | Send one decision (async, non-blocking) |
trace(...) | Multi-step agent context manager |
flush() | Drain queue before process exit (especially serverless) |
Principles
Zero latency
Zero latency
Sends run in a background queue.
observe() returns immediately.Zero dependencies
Zero dependencies
Python uses stdlib only. TypeScript uses platform
fetch.Failure silent
Failure silent
Network errors never throw to your agent loop. Enable
debug=True locally to see logs.Minimal example
Configuration
| Python | TypeScript | Env var |
|---|---|---|
api_key | apiKey | HISTEERIA_API_KEY |
base_url | baseUrl | HISTEERIA_BASE_URL |
timeout | timeoutMs | — |
enabled | enabled | — |
debug | debug | — |
https://api.histeeria.com
Next steps
Python SDK
Full Python reference.
TypeScript SDK
Node, edge, and browser usage.
Tracing
Multi-step agents.
Frameworks
LangChain, OpenAI, and more.

