pip install "getpatter[xai]"

npm install getpatter

# Namespaced import (pipeline mode)
from getpatter.tts import xai

tts = xai.TTS()                                            # reads XAI_API_KEY, voice "eve"
tts = xai.TTS(api_key="...", voice="leo", language="en")

# Flat alias (equivalent)
from getpatter import XaiTTS

tts = XaiTTS()

// Namespaced import (pipeline mode)
import * as xai from "getpatter/tts/xai";

const tts = new xai.TTS();                                 // reads XAI_API_KEY, voice "eve"
const tts2 = new xai.TTS({ apiKey: "...", voice: "leo", language: "en" });

// Flat alias (equivalent)
import { XaiTTS } from "getpatter";

const tts3 = new XaiTTS();

import asyncio
from getpatter import Patter, Twilio, DeepgramSTT, XaiTTS

phone = Patter(carrier=Twilio(), phone_number="+15550001234")

agent = phone.agent(
    stt=DeepgramSTT(),                                     # DEEPGRAM_API_KEY from env
    tts=XaiTTS.for_twilio(voice="eve"),                    # XAI_API_KEY from env
    system_prompt="You are a helpful assistant.",
)

asyncio.run(phone.serve(agent))

// npx tsx example.ts
import { Patter, Twilio, DeepgramSTT, XaiTTS } from "getpatter";

const phone = new Patter({ carrier: new Twilio(), phoneNumber: "+15550001234" });

const agent = phone.agent({
  stt: new DeepgramSTT(),                                  // DEEPGRAM_API_KEY from env
  tts: XaiTTS.forTwilio({ voice: "eve" }),                 // XAI_API_KEY from env
  systemPrompt: "You are a helpful assistant.",
});

await phone.serve({ agent });

from getpatter import xai_create_custom_voice, XaiTTS

with open("reference.wav", "rb") as f:                    # ≤120 s
    clip = f.read()
voice_id = await xai_create_custom_voice(
    name="Front Desk",
    language="en",
    audio=clip,
)

tts = XaiTTS(voice=voice_id)

import { readFile } from "node:fs/promises";
import { xaiCreateCustomVoice, XaiTTS } from "getpatter";

const clip = await readFile("reference.wav");             // ≤120 s
const voiceId = await xaiCreateCustomVoice({
  name: "Front Desk",
  language: "en",
  audio: clip,
});

const tts = new XaiTTS({ voice: voiceId });

# The tags travel inside the text your agent speaks.
tts = XaiTTS(voice="eve", language="en")
async for chunk in tts.synthesize(
    "So I walked in and [pause] there it was. [laugh] Incredible!",
):
    ...  # raw PCM-16-LE @ 16 kHz

// The tags travel inside the text your agent speaks.
const tts = new XaiTTS({ voice: "eve", language: "en" });
for await (const chunk of tts.synthesizeStream(
  "So I walked in and [pause] there it was. [laugh] Incredible!",
)) {
  // raw PCM-16-LE @ 16 kHz
}

from getpatter import XaiTTS

# Twilio Media Streams: μ-law @ 8 kHz native — bit-clean passthrough, no resample.
tts = XaiTTS.for_twilio(voice="eve")

# Telnyx: PCM @ 16 kHz — flows through the standard PCM16 path.
tts2 = XaiTTS.for_telnyx(voice="eve")

import { XaiTTS } from "getpatter";

// Twilio Media Streams: μ-law @ 8 kHz native — bit-clean passthrough, no resample.
const tts = XaiTTS.forTwilio({ voice: "eve" });

// Telnyx: PCM @ 16 kHz — flows through the standard PCM16 path.
const tts2 = XaiTTS.forTelnyx({ voice: "eve" });