.env.example

# -----------------------------------------------------------------------------
# AI Chatbot Template
# -----------------------------------------------------------------------------
# Duplicate this file as `.env.local` (or `.env`) and fill in the variables you
# actually need. Never commit real API keys to source control.
# -----------------------------------------------------------------------------

# --- Core Vercel AI SDK defaults ------------------------------------------------

# Primary provider you intend to use. (openai, anthropic, google, groq, mistral, etc.)
AI_PROVIDER=openai

# Default model that your API route should invoke.
AI_MODEL=gpt-4o

# Optional tuning knobs passed to the SDK call (numbers are strings in env files).
AI_TEMPERATURE=0.4
AI_MAX_TOKENS=2048

# Override the base URL if you proxy through a custom gateway.
# Leave blank when calling provider hosted APIs directly.
AI_BASE_URL=

# If you run through a hosted gateway that requires a project-scoped API key.
AI_API_KEY=
AI_PROJECT_ID=

# --- Provider specific keys -----------------------------------------------------
# Populate only the providers you plan to call. The Vercel AI SDK automatically
# picks the correct key based on the provider you instantiate in your API route.

OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GOOGLE_GENERATIVE_AI_API_KEY=
GEMINI_API_KEY=
GROQ_API_KEY=
MISTRAL_API_KEY=
FIREWORKS_API_KEY=
COHERE_API_KEY=
TOGETHER_API_KEY=
PERPLEXITY_API_KEY=
DEEPSEEK_API_KEY=
OPENROUTER_API_KEY=

# --- Supabase ------------------------------------------------------------------
# Server-side: keep these secret
SUPABASE_URL=
SUPABASE_ANON_KEY=
# Optional service role key (DO NOT expose to client)
SUPABASE_SERVICE_ROLE_KEY=

# Client-side: only expose safe, public values (Astro exposes PUBLIC_* to the client)
PUBLIC_SUPABASE_URL=
PUBLIC_SUPABASE_ANON_KEY=

# --- Convex --------------------------------------------------------------------
# Use either public URL (recommended for clients) or deployment slug for tooling.
NEXT_PUBLIC_CONVEX_URL=
PUBLIC_CONVEX_URL=
CONVEX_URL=
CONVEX_DEPLOYMENT=

# --- Optional observability / telemetry ----------------------------------------
# Uncomment when forwarding usage metrics to Vercel Observability.
# VERBOSE_AI_LOGGING=true
# VERCEL_LOG_LEVEL=debug
# AI_DEBUG=1

# -----------------------------------------------------------------------------
# Tips:
# 1. Keep `.env.local` out of git (already ignored by the template).
# 2. When deploying to Vercel, define the same variables in the dashboard under
#    Project Settings → Environment Variables.
# 3. In development, restart `pnpm dev` whenever you edit env vars.
# -----------------------------------------------------------------------------