🎉 ai-infra v1.0 is here — Production-ready AI/LLM infrastructure
What's new
nfrax logonfrax

Infrastructure that just works. Ship products, not boilerplate.

Frameworks

  • svc-infra
  • ai-infra
  • fin-infra
  • robo-infra

Resources

  • Getting Started
  • What's New
  • Contributing

Community

  • GitHub

© 2026 nfrax. All rights reserved.

nfrax logonfrax
Start HereWhat's New
GitHub
ai-infra / API Reference

RealtimeVoice

from ai_infra.llm import RealtimeVoice
View source
ai_infra.llm

High-level facade for real-time voice conversations. Automatically selects the best available provider based on environment configuration, or allows explicit provider selection. Provider Selection Order: 1. Explicit provider passed to constructor 2. REALTIME_VOICE_PROVIDER environment variable 3. First configured provider (OpenAI -> Gemini)

Attributes

config: The realtime configuration for voice sessions. provider: The underlying realtime provider instance.

Example

>>> # Auto-select provider >>> voice = RealtimeVoice() >>> >>> # Explicit provider >>> voice = RealtimeVoice(provider="openai") >>> >>> # Custom config >>> config = RealtimeConfig(model="gpt-4o-realtime-preview") >>> voice = RealtimeVoice(config=config)

Constructor
RealtimeVoice(provider: str | BaseRealtimeProvider | None = None, config: RealtimeConfig | None = None) -> None
ParameterTypeDefaultDescription
providerstr| BaseRealtimeProvider |NoneNoneProvider name ("openai", "gemini") or provider instance. If None, auto-selects based on environment.
configRealtimeConfig |NoneNoneConfiguration for the realtime session. If None, uses default configuration.

Methods

On This Page

Constructoravailable_providersclassmethodconfigured_providersclassmethodconnectasyncon_audioon_erroron_interruptedon_tool_callon_transcriptregister_providerclassmethodrunasync