Python Quickstart

pip install "lokutor[audio]"   # includes PyAudio for the speakers and microphone used below

export LOKUTOR_API_KEY=sk_your_key_here

import os
import wave
from lokutor import TTSClient, VoiceStyle, Language

client = TTSClient(api_key=os.environ["LOKUTOR_API_KEY"])
chunks = []

client.synthesize(
    text="Hello from Lokutor.",
    voice=VoiceStyle.F1,
    language=Language.ENGLISH,
    on_audio=chunks.append,
    play=False,
    block=True,
)

with wave.open("hello.wav", "wb") as f:
    f.setnchannels(1)
    f.setsampwidth(2)
    f.setframerate(44100)
    f.writeframes(b"".join(chunks))

from lokutor import VoiceAgentClient, VoiceStyle, Language
import os

client = VoiceAgentClient(
    api_key=os.environ['LOKUTOR_API_KEY'],
    prompt="You are a helpful assistant.",
    voice=VoiceStyle.F1,
    language=Language.ENGLISH,
)

client.start_conversation()  # talk through your microphone; Ctrl+C to stop

def on_transcription(text):
    print(f"You: {text}")

def on_response(text):
    print(f"Agent: {text}")

def on_status(status):
    print(f"Status: {status}")

client.on('transcription', on_transcription)
client.on('response', on_response)
client.on('status', on_status)

history = client.get_transcript()
text = client.get_transcript_text()

client.update_prompt("You are now a technical expert.")

def on_tool_call(name, arguments, call_id):
    # arguments is a JSON string
    client.submit_tool_result(call_id, {"ok": True})

client.on('tool_call', on_tool_call)