Private BetaWe're currently in closed beta.Join the waitlist
empress
SDK

Official SDKs for
every language.

Type-safe SDKs for Python, Node.js, and Go. Track any AI agent action with a single function call. Automatic batching and retries.

Quick startFull 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 context capture automatically.

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 waitlistPreview quickstart →