Skip to main content
Official Python client for the Kupe voice API.
Import from kupe import Kupe. Default host is https://x.kupe.in. Optional KUPE_BASE_URL. Paths always join as {base}/v1/....
Create a project key in hub.kupe.in. It looks like sk-kupe-....

Run a realtime turn (terminal)

This is a complete script. Paste it after installing and exporting the key.
Reuse an existing agent from the editor with agent_id="agt_..." instead of name=. Pass voice="priya" or voice_id="..." (copy from the voice library). See Realtime. Streaming mic audio instead of text? If the agent plays through open speakers, pass echo_suppression="half_duplex" so it does not hear and answer itself — see Realtime.

Who am I

API keys are scoped to one org and one project. GET /v1/me fills them in, so most calls need no ids.

List agents

Create an agent

Write spoken prompts — see Voice agent prompting.

Constructor

Do not put /v1 in KUPE_BASE_URL.

Resources

client.agents, realtime, sessions, inbound, campaigns, recipient_lists, tools, composio, analyses, databases, knowledge_bases, phones, voices, providers, logs, billing, usage, orgs, projects. Voice clone / patch / delete need a user JWT. Payments are dashboard-only. Next: Realtime · Quickstart · API reference