SDK Overview

The Lokutor SDKs handle the WebSocket connections, audio capture and playback, resampling, and conversation state. The JavaScript and Python SDKs have the same classes.

Installation

JavaScript
Python

npm install @lokutor/sdk

Works in browsers (Vite, React, vanilla) and in Node.js 22 or later (the SDK uses the global WebSocket). Browser apps play audio with the Web Audio API. Current version: 1.6.0.

pip install lokutor

Requires Python 3.8 or later. That is all you need to call the API. To play or record audio on the local machine (play=True, start_conversation(), live microphone transcription), install the audio extra, which needs the PortAudio library:

brew install portaudio            # macOS
sudo apt install portaudio19-dev  # Debian / Ubuntu
pip install "lokutor[audio]"

Current version: 1.5.0.

Credentials

Create an API key at app.lokutor.com and keep it on the server:

export LOKUTOR_API_KEY=sk_your_key_here

In a browser, never use the key itself. Your backend exchanges it for a short-lived ticket and the page passes the ticket: VoiceAgentClient fetches one before every connection through its auth option. See Secure browser setup.

Clients

Client	Endpoint	Use it for
`TTSClient`	`WS /ws/tts`	Text to streamed audio
`STTClient`	`POST /stt/transcribe`	Transcribe a recorded clip
`SpeechToTextClient`	`WS /ws/stt`	Live transcription from a microphone
`VoiceAgentClient`	`WS /ws/agent`	Full-duplex conversations, with tools

Discovery helpers read the voices, languages and limits without a key.

Platform notes

Browser: the microphone and AudioContext need a user gesture (a click). See Browser Setup.
Node.js: needs Node.js 22+. For microphone and speaker, install speaker and node-record-lpcm16 and use NodeAudioManager. See Node.js Setup.
Python: local audio uses PyAudio, installed with lokutor[audio].

Reference

JavaScript API Reference
Python API Reference
Source and examples: github.com/lokutor-ai/lokutor-sdk (js/examples, python/examples)

Get Started

SDK

API Reference

Resources

Installation

Credentials

Clients

Platform notes

Reference

​Installation

​Credentials

​Clients

​Platform notes

​Reference

Installation

Credentials

Clients

Platform notes

Reference