Skip to content

Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.

4.4 KB
Raw Blame
# ============================================================
#  Personal Jarvis — environment variables (template)
# ------------------------------------------------------------
#  Copy this file to `.env` and fill in your real keys, OR run the
#  setup wizard (`python -m dodaios --wizard`), which stores keys in
#  your OS credential manager instead. `.env` is NOT committed
#  (see .gitignore). NEVER put real keys in jarvis.toml or any
#  committed file.
#
#  Secret resolution order (dodaios/core/config.py:get_secret):
#    1. OS credential manager (keyring, service "dodaios"; keys saved before the
#       rename are still read from "personal-jarvis")
#    2. environment variable
#    3. this .env file (dev fallback only)
#
#  A JARVIS_* name below may also be written DODAIOS_*; if both are set,
#  the DODAIOS_ one wins.
#
#  Every provider is OPTIONAL — set only the keys you actually use.
#  A single cloud Brain key (e.g. GEMINI_API_KEY) is enough to boot.
# ============================================================


# ---- Brain providers ------------------------------------------
# Gemini (Google AI Studio) — default Brain. https://aistudio.google.com/app/apikey
GEMINI_API_KEY=
GOOGLE_AIStudio_API_KEY=
# Google Cloud Vertex AI — the SAME Gemini models, billed to a Cloud project
# instead of an AI Studio account. https://console.cloud.google.com/vertex-ai/studio
# One credential serves brain, tool model, STT, TTS, realtime and subagents.
# Either an express-mode key (AQ.) or a Cloud API key restricted to
# aiplatform.googleapis.com. For a production project set no key at all and use
# JARVIS__GOOGLE__VERTEX_PROJECT below (Application Default Credentials).
VERTEX_API_KEY=
JARVIS__GOOGLE__VERTEX_PROJECT=
# Region for the project path. "global" has the widest Gemini availability;
# name a single region when data residency requires it.
JARVIS__GOOGLE__VERTEX_LOCATION=
# Only needed when this machine is not already signed in with gcloud.
JARVIS__GOOGLE__SERVICE_ACCOUNT_PATH=
# Anthropic Claude. https://console.anthropic.com/settings/keys
ANTHROPIC_API_KEY=
# OpenAI (GPT brain, Whisper STT, TTS). https://platform.openai.com/api-keys
OPENAI_API_KEY=
OPENAI_ORG_ID=
# OpenAI Codex CLI worker (separate from the OpenAI brain key).
CODEX_OPENAI_API_KEY=
# OpenRouter — universal gateway to all models via one key. https://openrouter.ai/keys
OPENROUTER_API_KEY=
# xAI Grok (brain + Grok Voice TTS). https://console.x.ai/
GROK_API_KEY=


# ---- Speech-to-Text (STT) -------------------------------------
# Groq Whisper — ultra-fast cloud STT (default). https://console.groq.com/keys
GROQ_API_KEY=
# Deepgram — Flux / Nova-3 with integrated end-of-turn. https://console.deepgram.com/
DEEPGRAM_API_KEY=
# OpenAI Whisper STT reuses OPENAI_API_KEY (see above).


# ---- Text-to-Speech (TTS) -------------------------------------
# Cartesia Sonic 3.5 — 42 languages incl. German. https://play.cartesia.ai/keys
CARTESIA_API_KEY=
# ElevenLabs premium TTS. https://elevenlabs.io/app/settings/api-keys
ELEVENLABS_API_KEY=
ELEVENLABS_VOICE_ID=
# Grok Voice TTS reuses GROK_API_KEY (see above).
# Google Cloud TTS (Neural2) — path to a service-account JSON.
GOOGLE_APPLICATION_CREDENTIALS=
# Gemini Flash TTS via Vertex AI (bypasses the AI-Studio preview RPD cap):
# set your GCP project id here; SA path is in jarvis.toml [tts].service_account_path.
JARVIS__TTS__VERTEX_PROJECT=


# ---- Web search (optional prepaid hop) ------------------------
# Live web search works with no key (DuckDuckGo). To use a prepaid
# Google hop instead of Tavily / Serper / Brave, one Apifare token:
# https://apifare.com/start  (env name APIPAY_TOKEN is the official one)
APIPAY_TOKEN=


# ---- Weather --------------------------------------------------
# https://openweathermap.org/api
OPENWEATHER_API_KEY=


# ---- Channels & telephony -------------------------------------
# Telegram bot. https://t.me/BotFather
TELEGRAM_BOT_TOKEN=
# Discord bot. https://discord.com/developers/applications
DISCORD_BOT_TOKEN=
# Twilio — call Jarvis on a phone number. Auth token only; Account SID +
# number live in jarvis.toml [integrations.twilio]. https://console.twilio.com
TWILIO_AUTH_TOKEN=


# ---- Admin helper ---------------------------------------------
# HMAC key for Phase-5 admin ops (winget/services/registry/firewall).
# Auto-generated on first helper start — you normally do NOT set this by hand.
JARVIS_ADMIN_HMAC=


# ---- App settings ---------------------------------------------
APP_ENV=development
LOG_LEVEL=info