Introduction

Build and operate Talkr voice AI agents programmatically from Python or TypeScript

Talkr ships official SDKs for Python and TypeScript that wrap the Talkr REST API and the workflow builder. Use them to create or edit agents, place outbound calls, and inspect runs from your own code.

Python — talkr-sdk on PyPI
TypeScript — @talkr/sdk on npm

Both packages are generated from the same backend OpenAPI spec, so the method surface is equivalent between them — only the naming convention differs (snake_case in Python, camelCase in TypeScript).

The SDKs currently expose a curated subset of the full API — workflows, tools, credentials, knowledge base, node types, recordings, and outbound test calls. Campaigns, organizations, and user management aren't wrapped as typed methods yet; call those directly against the REST API with an HTTP client (both SDKs' underlying base_url/api_key config works for this too). Check the API Reference for the complete, always-current endpoint list.

Install

pip install talkr-sdk

npm install @talkr/sdk

Authenticate

Generate an API key at /api-keys (or http://localhost:3010/api-keys for self-hosted). See API Keys for details.

Both SDKs read the API key from the TALKR_API_KEY environment variable by default, and the base URL from TALKR_API_URL (defaults to http://localhost:8000). You can also pass them explicitly.

from talkr_sdk import TalkrClient

client = TalkrClient(
    base_url="https://talkr.intelstacks.com",
    api_key="YOUR_API_KEY",
)

import { TalkrClient } from "@talkr/sdk";

const client = new TalkrClient({
    baseUrl: "https://talkr.intelstacks.com",
    apiKey: "YOUR_API_KEY",
});

For self-hosted deployments, swap baseUrl for your backend URL (e.g. http://localhost:8000).

Quick tour

List the agents in your workspace:

workflows = client.list_workflows()
for wf in workflows:
    print(wf.id, wf.name)

const workflows = await client.listWorkflows();
for (const wf of workflows) {
    console.log(wf.id, wf.name);
}

Next steps

Build an agent — assemble nodes and edges, save as a draft
Place an outbound call — trigger a call from an agent to a phone number
MCP Server — let Claude and other coding agents drive the SDK for you

Introduction

Install

Authenticate

Quick tour

Next steps

On this page