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>
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
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
Requirements
- Python 3.9+
- aiohttp>=3.9.0
License
MIT License - see LICENSE file for details.
Links
Support
For support, email support@cekura.ai
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cekura-1.6.0.tar.gz.
File metadata
- Download URL: cekura-1.6.0.tar.gz
- Upload date:
- Size: 87.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b850774eab0346ace5e6dfcfa8a790c33e847fb6beb037445a3fccb5bb340525
|
|
| MD5 |
2779330d10ec35b9bb7460e18efb38d8
|
|
| BLAKE2b-256 |
8157a420f74fa10c35934e36b0205cc51916d2b9f0c41374e89515e347774ce6
|
File details
Details for the file cekura-1.6.0-py3-none-any.whl.
File metadata
- Download URL: cekura-1.6.0-py3-none-any.whl
- Upload date:
- Size: 122.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
981da8f36ff0a6aa4a69cf642b1552dba63e47ee6ecc7ce23cf5dcc965988e37
|
|
| MD5 |
7610430027809873a1f5608b620bb7f9
|
|
| BLAKE2b-256 |
3ce06245a16d94e4e56a482b2d346e63c358c1496d468bc152feca540fb50247
|
