SDK

Official SDKs for every language

Type-safe SDKs for Python, Node.js, and Go. Full xAPI support with automatic context capture. Track any AI agent action with a single function call.

Quick start Full documentation →

🐍

Python

v1.0.0

pip install empress

Python 3.8+
Async support
Type hints
Auto-retry

View on GitHub →

⬢

Node.js

v1.0.0

npm install @empress/sdk

Node 18+
TypeScript
ESM & CJS
Edge runtime

View on GitHub →

🔵

Go

v1.0.0

go get github.com/empress/sdk-go

Go 1.21+
Context support
Struct tags
Zero deps

View on GitHub →

Simple, powerful API

One function to track any action. The SDK handles batching, retries, and automatic context capture. Your actions are recorded in xAPI format.

track()

Record an agent action with full context. Required fields: actor, verb, object.

actorstringAgent identifier

verbstringAction taken

objectstringTarget of action

resultobjectOutcome data (optional)

contextobjectAdditional context (optional)

query()

Search and filter actions programmatically. Supports all the same filters as the dashboard.

export()

Export actions in JSON or CSV format. Stream large datasets efficiently.

Example Usage

from empress import Empress

empress = Empress(api_key="...")

# Track a complex action
empress.track(
    actor="finance-agent-v2.3",
    verb="approved",
    object="loan-application-8921",
    result={
        "success": True,
        "decision": "approved",
        "amount": 50000,
        "interest_rate": 0.075,
        "confidence": 0.92,
        "processing_time_ms": 847
    },
    context={
        "customer_id": "cust-12847",
        "credit_score": 720,
        "revenue_trend": "+15%",
        "debt_ratio": 0.3,
        "model_version": "v2.3.1",
        "reasoning": [
            "Strong credit score",
            "Positive revenue growth",
            "Low debt ratio"
        ]
    }
)

# Query recent actions
actions = empress.query(
    actor="finance-agent-*",
    verb="approved",
    since="24h"
)

# Export for compliance
empress.export(
    format="json",
    since="2026-01-01",
    until="2026-02-01",
    output="audit-q1.json"
)

REST API

Works with any language

No SDK for your language? Use the REST API directly. Simple POST requests with JSON payloads. Full OpenAPI specification available.

View API Reference →

cURL

curl -X POST https://api.empress.eco/v1/track \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actor": "support-agent",
    "verb": "resolved",
    "object": "ticket-892",
    "result": {
      "success": true,
      "resolution_time_minutes": 4
    }
  }'

Private Beta

Ready to get started?

Join the waitlist to get early access. Beta users get direct founder support.

Join the waitlist Preview quickstart →