Cekura Python SDK

Testing and Observability for AI Voice Agents. Launch in minutes not weeks by ensuring your agents deliver a seamless experience in every conversational scenario.

Installation

pip install cekura

SDK

The Python SDK provides a sync and async API client for the Cekura platform.

pip install cekura[sdk]

from cekura import Cekura

client = Cekura(api_key="your-api-key")

# List agents
agents = client.agents.list()

# Get a specific agent
agent = client.agents.get(agent_id=123)

# List scenarios for a project
scenarios = client.scenarios.list(project_id=42)

# Run test cases from a checked-in JSON spec, without creating evaluators.
# dry_run validates and prices the spec without running or charging anything.
import json
spec = json.load(open("tests/agent-suite.json"))
plan = client.scenarios.run_json(spec, agent_id=123, dry_run=True)
result = client.scenarios.run_json(spec, agent_id=123, channel="voice")

For async usage:

from cekura import AsyncCekura

async with AsyncCekura(api_key="your-api-key") as client:
    agents = await client.agents.list()

See the API documentation for the full resource reference.

CLI

The CLI lets you manage agents, scenarios, metrics, and test runs from the terminal.

pip install cekura[cli]

# Authenticate
cekura auth login

# List your agents
cekura agents list

# Start a test run
cekura run start --agent-id 123 --scenario-id 456

# Stream run progress
cekura run watch <run-id>

→ CLI Reference Guide

Integrations

LiveKit

• One-line integration for simulation and observability
• Automatic metrics collection (STT, LLM, TTS, EOU)
• Session logs capture
• Mock tool injection for testing
• Dual-channel audio recording
• Built-in OpenTelemetry export for LiveKit agent traces

→ LiveKit Integration Guide

Pipecat

• Automatic transcript capture with timestamps
• Audio recording with S3 upload
• Built-in OpenTelemetry tracing (conversation, turn, STT/LLM/TTS spans)
• Session logs capture
• Minimal 3-line integration

→ Pipecat Integration Guide

Requirements

• Python 3.9+
• aiohttp>=3.9.0

License

MIT License - see LICENSE file for details.

Links

• Homepage
• Documentation
• Dashboard

Support

For support, email support@cekura.ai