Skip to main content

Environment Variables

All environment variables go in .env.local at the project root. Restart the dev server after changes.

Framework

VariableRequiredDescription
LIVEKIT_URLLiveKit server WebSocket URL (wss://...)
LIVEKIT_API_KEYLiveKit API key
LIVEKIT_API_SECRETLiveKit API secret

Core

VariableRequiredDescription
BUILDER_LLM_PROVIDERLLM provider for the AI flow generator: anthropic (default) or gemini
BUILDER_LLM_ANTHROPIC_API_KEY✅ when BUILDER_LLM_PROVIDER=anthropicAI flow generator (Anthropic)
BUILDER_LLM_GEMINI_API_KEY✅ when BUILDER_LLM_PROVIDER=geminiAI flow generator (Gemini)
BUILDER_STT_PROVIDERSTT provider for voice dictation: deepgram (default) or gemini
BUILDER_STT_DEEPGRAM_API_KEY✅ when BUILDER_STT_PROVIDER=deepgramVoice dictation in builder (Deepgram)
BUILDER_STT_GEMINI_API_KEY✅ when BUILDER_STT_PROVIDER=geminiVoice dictation in builder (Gemini)

LLM

VariableProvider
OPENAI_API_KEYOpenAI
GEMINI_API_KEYGoogle Gemini
GROQ_API_KEYGroq
TOGETHER_API_KEYTogether AI
MOONSHOT_API_KEYMoonshot AI
DEEPSEEK_API_KEYDeepSeek
MISTRALAI_API_KEYMistral AI
CEREBRAS_API_KEYCerebras
FIREWORKS_API_KEYFireworks AI
PERPLEXITY_API_KEYPerplexity
XAI_API_KEYxAI
OPENROUTER_API_KEYOpenRouter
OVHCLOUD_API_KEYOVHCloud
BEDROCK_API_KEYAmazon Bedrock
LETTA_API_KEYLetta
OLLAMA_API_KEYOllama (local)
TELNYX_API_KEYTelnyx

TTS

VariableProvider
ELEVENLABS_API_KEYElevenLabs
CARTESIA_API_KEYCartesia
NEUPHONIC_API_KEYNeuphonic
RESEMBLE_API_KEYResemble AI
RIME_API_KEYRime
INWORLD_API_KEYInworld

STT

VariableProvider
ASSEMBLYAI_API_KEYAssemblyAI
FAL_API_KEYfal.ai
GLADIA_API_KEYGladia
SONIOX_API_KEYSoniox
SPEECHMATICS_API_KEYSpeechmatics

Integrations

VariableDescription
EXA_API_KEYExa.ai web search

Sharing

VariableRequiredDescription
LIVEKIT_SANDBOX_IDLiveKit Sandbox Token Server ID — needed for public share links. Enable at LiveKit Cloud Settings.

Database

VariableRequiredDescription
DATABASE_URLPostgreSQL connection string (e.g. postgresql://voiceblox:voiceblox@localhost:5432/voiceblox)
ENCRYPTION_KEY64-char hex key for AES-256-GCM encryption of stored provider credentials. Generate with: openssl rand -hex 32

Notes

  • OPENAI_API_KEY is shared across LLM, TTS (gpt-4o-mini-tts), and STT (Whisper)
  • BUILDER_STT_DEEPGRAM_API_KEY is for voice dictation in the builder only; use DEEPGRAM_API_KEY for Deepgram STT/TTS nodes in your flow
  • GROQ_API_KEY is shared across LLM and TTS
  • BUILDER_LLM_ANTHROPIC_API_KEY is for the AI flow generator only; use ANTHROPIC_API_KEY for Anthropic LLM nodes in your flow
  • BUILDER_LLM_GEMINI_API_KEY and BUILDER_STT_GEMINI_API_KEY can hold the same Google API key value if you use a single Google project