Configuration reference

app.DefaultConfigFromEnv() reads environment variables into app.AppConfig.

Use this page as a compact map for common environment-backed settings. It is not the complete list of fields in AppConfig; inspect app.DefaultConfigFromEnv() when adding or verifying an option.

Model selection

Field	Environment variable
Instructions	RTP_AGENT_INSTRUCTIONS
LLMProvider	RTP_AGENT_LLM_PROVIDER
LLMModel	RTP_AGENT_LLM_MODEL
LLMBaseURL	RTP_AGENT_LLM_BASE_URL
STTProvider	RTP_AGENT_STT_PROVIDER
STTModel	RTP_AGENT_STT_MODEL
STTLanguage	RTP_AGENT_STT_LANGUAGE
VADProvider	RTP_AGENT_VAD_PROVIDER
TTSProvider	RTP_AGENT_TTS_PROVIDER
TTSModel	RTP_AGENT_TTS_MODEL
TTSVoice	RTP_AGENT_TTS_VOICE
RealtimeProvider	RTP_AGENT_REALTIME_PROVIDER
RealtimeModel	RTP_AGENT_REALTIME_MODEL
AvatarProvider	RTP_AGENT_AVATAR_PROVIDER
TurnDetectorProvider	RTP_AGENT_TURN_DETECTOR_PROVIDER
Smart turn gRPC endpoint (when provider cavos)	RTP_AGENT_SMART_TURN_GRPC_ADDR

LiveKit and transport

Field	Environment variable
LiveKit API key	LIVEKIT_API_KEY
LiveKit API secret	LIVEKIT_API_SECRET
Worker transport	RTP_AGENT_TRANSPORT
Agora app ID	AGORA_APP_ID
Agora app certificate	AGORA_APP_CERTIFICATE
Agora channel	AGORA_CHANNEL
Agora UID	AGORA_UID
Agora token	AGORA_TOKEN

Provider credentials

Provider credentials are read into AppConfig fields. Common examples:

• OPENAI_API_KEY
• ANTHROPIC_API_KEY
• DEEPGRAM_API_KEY
• GOOGLE_API_KEY
• GOOGLE_APPLICATION_CREDENTIALS
• AWS_REGION
• ELEVENLABS_API_KEY
• GROQ_API_KEY
• XAI_API_KEY
• LIVEKIT_API_KEY
• LIVEKIT_API_SECRET

How to use this reference

• Use environment variables for deploy-time choices.
• Use direct AppConfig fields for values owned by code.
• Use adapter constructor options when a provider-specific setting is not exposed by AppConfig.
• Do not document an environment variable unless it is read in source.

Check app.DefaultConfigFromEnv for the complete list at this version.