Skip to main content

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)

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

Support

For support, email support@cekura.ai

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cekura-1.5.2.tar.gz (76.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cekura-1.5.2-py3-none-any.whl (109.4 kB view details)

Uploaded Python 3

File details

Details for the file cekura-1.5.2.tar.gz.

File metadata

  • Download URL: cekura-1.5.2.tar.gz
  • Upload date:
  • Size: 76.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for cekura-1.5.2.tar.gz
Algorithm Hash digest
SHA256 8e00213c1cff187e2151718b896a2de067b7e7f619f27bd8221435fa8a935c95
MD5 0e641cf058bb6f8cd220a1d15522f1da
BLAKE2b-256 2d09839c5815e7739fed0729a08da32b929d9ddda2b48f2949425fc449ceb8ea

See more details on using hashes here.

File details

Details for the file cekura-1.5.2-py3-none-any.whl.

File metadata

  • Download URL: cekura-1.5.2-py3-none-any.whl
  • Upload date:
  • Size: 109.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for cekura-1.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 031ef8a849bde4fd6d24c9d1bd22a13fce354f5aacd97721f69f87bbf95dbbb4
MD5 3fdefb3f30c7bae65cb556febfd5faa3
BLAKE2b-256 45498f3c9d5542ba30c7655f985d876fc68f87d12e6f64001c4d7af468d033ef

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page