TeenageWorks SDK

The official SDK for Teen V1, including process-wide compatibility patches for the OpenAI and ElevenLabs clients.

Version 0.0.1b1 includes:

• TeenageWorks, AsyncTeenageWorks, TW, and AsyncTW clients
• OpenAI-style buffered, raw, HTTP-streaming, and SSE responses
• persistent incremental-text WebSocket sessions
• voice ID selection and zero-shot reference-audio cloning
• typed models for models, capabilities, public voices, and project usage
• process-wide OpenAI and ElevenLabs TTS routing patches
• provider pass-through, compatibility warnings, and typed errors

Install the package from PyPI:

python -m pip install teenageworks

Generate speech:

from teenageworks import TeenageWorks

client = TeenageWorks(api_key="tw_live_...")
audio = client.audio.speech.create(
    model="teen-v1",
    voice="default",
    input="Hello from Teen V1.",
    response_format="mp3",
)
audio.write_to_file("speech.mp3")

Provider patches are explicit and affect only recognized TTS calls:

from teenageworks import patch_elevenlabs, patch_openai

patch_openai()
patch_elevenlabs()

The complete documentation lives in docs/.