Mini Betav0.2.4
Khidemonas — API & Live Simulator
Stream HRV-style alignment telemetry, enforce policy-based safety, and export detailed runs for auditing—built for teams who need continuous assurance.
Status
Live
Exports
JSON • CSV • PDF
WS
Realtime
Why Khidemonas
Alignment Enforcement
Policy engine evaluates model I/O and flags violations with structured details.
Live Telemetry
WebSocket stream of beats with score, color, violations, and confidence.
Audit Exports
Download complete run logs as JSON, CSV, or a formatted PDF report.
Simulation-first
Attach your API key, stream responses, and iterate safely before production.
Getting Started
pip install custos-lab
pip install python-dotenv
# .env:
# CUSTOS_API_KEY=<your-key>
# CUSTOS_BACKEND_URL=https://custoslabs-backend.onrender.com
import os
from dotenv import load_dotenv
import custos
load_dotenv()
os.environ["CUSTOS_BACKEND_URL"] = os.getenv("CUSTOS_BACKEND_URL", "")
custos.set_api_key(os.getenv("CUSTOS_API_KEY", ""))
guardian = custos.guardian()
guardian.evaluate(prompt="Hello", response="Hi there!") # streams beats to your live run
Use the same account that created the run. Create an API key first.
Exports & Reports
- JSON: Raw structured logs for analytics pipelines.
- CSV: Spreadsheet-friendly format for ops review.
- PDF: Paginated report including timestamps, scores, violations, prompt/response snippets.
Access via the Simulator’s Export panel, or GET:
/simulator/export/<run_id>/?format=csv|json|pdfChangelog
v0.2.4 (Mini Beta)
- Added CSV & PDF export endpoints
- Improved websocket auto-reconnect & sticky sessions
- Zoomable HiDPI HRV canvas
- Minor UI polish and better error toasts