Feature Key Matrix | Dataspheres AI Docs - Dataspheres AI

Feature Key Matrix Every optional vendor integration in Dataspheres AI is controlled by a single environment variable. Set the key to enable the feature; r...

Feature Key Matrix Every optional vendor integration in Dataspheres AI is controlled by a single environment variable. Set the key to enable the feature; remove it to disable gracefully. The platform boots and runs its core functionality without any of these keys. How It Works At startup the server prints a feature status table (also available at GET /api/health/features ). Each feature wraps its vendor client in an optional-client guard that checks for its key at call time. No key? The guard returns a structured error instead of throwing, and the UI displays a friendly "feature not available" state. Feature Registry Feature Enable with Description Disabled behavior local-llm LOCAL_LLM_BASE_URL Self-hosted LLM via OpenAI-compatible endpoint (Ollama/vLLM) Feature reports disabled; API calls return a 503 with a hint to set the key. openai OPENAI_API_KEY AI completions, embeddings, image vision Feature reports disabled; API calls return a 503 with a hint to set the key. elevenlabs ELEVENLABS_API_KEY Text-to-speech + conversational AI Feature reports disabled; API calls return a 503 with a hint to set the key. sendgrid SENDGRID_API_KEY Transactional email delivery Feature reports disabled; API calls return a 503 with a hint to set the key. stripe STRIPE_SECRET_KEY Billing, subscriptions, checkout Feature reports disabled; API calls return a 503 with a hint to set the key. twilio TWILIO_ACCOUNT_SID SMS notifications for newsletter threads Feature reports disabled; API calls return a 503 with a hint to set the key. vertex_ai VERTEX_PROJECT_ID Google Imagen 3 / Veo 3 media generation Feature reports disabled; API calls return a 503 with a hint to set the key. deepseek DEEPSEEK_API_KEY DeepSeek LLM completions (fallback) Feature reports disabled; API calls return a 503 with a hint to set the key. google_drive GOOGLE_CREDENTIALS_BASE64 Google Drive sync / document import Feature reports disabled; API calls return a 503 with a hint to set the key. Checking Status at Runtime curl http://localhost:3000/api/health/features Returns a JSON array: [ { "feature": "openai", "enableWith": "OPENAI_API_KEY", "enabled": false }, { "feature": "elevenlabs", "enableWith": "ELEVENLABS_API_KEY", "enabled": true }, ... ] Adding a Key Without Restarting Update .env.oss (or your runtime env) and restart only the app container: docker compose -f docker-compose.oss.yml restart app The feature activates immediately on next request — no code deploy required. Boot-Time Log On every startup the server prints the full feature table to stdout: 📋 [ENV REPORT] Vendor feature status: -------------------------------------------- Feature Status Enable with -------------------------------------------- openai ⬜ OFF OPENAI_API_KEY elevenlabs ✅ ON (active) sendgrid ⬜ OFF SENDGRID_API_KEY stripe ⬜ OFF STRIPE_SECRET_KEY twilio ⬜ OFF TWILIO_ACCOUNT_SID vertex_ai ⬜ OFF VERTEX_PROJECT_ID deepseek ⬜ OFF DEEPSEEK_API_KEY google_drive ⬜ OFF GOOGLE_CREDENTIALS_BASE64 -------------------------------------------- See the Environment Variable Reference page for per-variable documentation including required vs. optional status and example values.