The Histeeria SDK sends agent decisions to the API with zero latency impact on your agent.

Packages

LanguageInstallImport
Python 3.8+pip install histeeriafrom histeeria import Histeeria
Node 18+ / TSnpm install histeeriaimport { Histeeria } from "histeeria"

Core API

Every SDK exposes:
MethodPurpose
observe(...)Send one decision (async, non-blocking)
trace(...)Multi-step agent context manager
flush()Drain queue before process exit (especially serverless)

Principles

Sends run in a background queue. observe() returns immediately.
Python uses stdlib only. TypeScript uses platform fetch.
Network errors never throw to your agent loop. Enable debug=True locally to see logs.

Minimal example

from histeeria import Histeeria

h = Histeeria()  # reads HISTEERIA_API_KEY
h.observe(input=messages, output=response, agent_id="bot-1")
h.flush()

Configuration

PythonTypeScriptEnv var
api_keyapiKeyHISTEERIA_API_KEY
base_urlbaseUrlHISTEERIA_BASE_URL
timeouttimeoutMs
enabledenabled
debugdebug
Default base URL: 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.