voicerun_completions 0.3.0

VoiceRun Completions

voicerun_completions

A comprehensive, unified SDK for interacting with multiple LLM providers (OpenAI, Anthropic, Google, and Vertex Anthropic) through a single, consistent API. This library simplifies working with different providers by normalizing their APIs and providing powerful features like automatic fallbacks, retry logic, and advanced streaming options.

Quick Start

from primfunctions.events import Event, StartEvent, TextEvent, TextToSpeechEvent
from primfunctions.context import Context
from voicerun_completions import generate_chat_completion

async def handler(event: Event, context: Context):
    if isinstance(event, StartEvent):
        yield TextToSpeechEvent(
            text="Hello! Ask me anything and I'll answer your question.",
            voice="nova"
        )

    if isinstance(event, TextEvent):
        user_message = event.data.get("text", "")
        
        response = await generate_chat_completion({
            "provider": "openai",
            "api_key": context.variables.get("OPENAI_API_KEY"),
            "model": "gpt-5-mini",
            "messages": [
                {"role": "user", "content": user_message}
            ]
        })
        
        if response.message.content:
            yield TextToSpeechEvent(
                text=response.message.content,
                voice="nova"
            )

Documentation

• Installation - Installation instructions and prerequisites
• Core Concepts - Providers, message types, and request formats
• Basic Usage - Getting started with chat completions
• Streaming - Token and sentence-based streaming
• Tool/Function Calling - Using tools and function calling
• Reliability: Retries & Fallbacks - Retry logic and automatic fallbacks
• Advanced Features - Cache breakpoints, vendor-specific options, and more
• API Reference - Complete API documentation
• Examples - Complete working examples
• Best Practices - Best practices and error handling

Features

• Unified API - Single interface for OpenAI, Anthropic, Google, and Vertex Anthropic
• Automatic Fallbacks - Seamlessly fallback to alternative providers on failure
• Retry Logic - Built-in exponential backoff retry mechanism
• Advanced Streaming - Token-based and sentence-based streaming for real-time applications
• Tool Calling - Unified tool/function calling across all providers
• Type Safety - Full type hints and support for both dict and object formats