Skip to main content

Testing and Observability SDK for AI Agents — tracing, API client, and CLI

Project description

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

→ LiveKit Integration Guide

Pipecat

  • Automatic transcript capture with timestamps
  • Audio recording with S3 upload
  • Minimal 3-line integration
  • Automatic cleanup

→ 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

Project details


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.3.0rc3.tar.gz (52.3 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.3.0rc3-py3-none-any.whl (70.3 kB view details)

Uploaded Python 3

File details

Details for the file cekura-1.3.0rc3.tar.gz.

File metadata

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

File hashes

Hashes for cekura-1.3.0rc3.tar.gz
Algorithm Hash digest
SHA256 c70c8fd2304da99f1562dc089f8c3891d26ee9d4f5ad937e87db2e641fbefa6f
MD5 1493fe9986742087a16717bf2f64c75a
BLAKE2b-256 377febbbc45c51d264dfb32bd69951c6c4fc05fe357c6e303ddd7679c2baf5b2

See more details on using hashes here.

File details

Details for the file cekura-1.3.0rc3-py3-none-any.whl.

File metadata

  • Download URL: cekura-1.3.0rc3-py3-none-any.whl
  • Upload date:
  • Size: 70.3 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.3.0rc3-py3-none-any.whl
Algorithm Hash digest
SHA256 b2149c34e21a5febf103adccc6ff514f9d38296764180a308506e72eb4b864c9
MD5 427802f8623c1447f584f4fa839b1c11
BLAKE2b-256 5ec85cb54cac9287df79f8d609f4f8000b899d6f763fece93361724541bc9f78

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 Pingdom Monitoring Sentry Error logging StatusPage Status page