AI Settings
Configure Gemini-backed AI and validate connectivity for the v2 UI.
AI configuration status
The backend AI stack (Gemini + ATOMIC kernel) is configured entirely via environment variables on the Dev VM. Use this page to see current status and test candidate keys and models without persisting secrets.
Reads GOOGLE_GEMINI_API_KEY inside the backend container. Managed via the VM's .env, not this UI.
Resolved from GOOGLE_GEMINI_MODEL when set; otherwise defaults to gemini-3.8-flash.
When configured, the same Gemini stack powers both the floating AI chat widget and AI Reports page.
Gemini API key
Use this section to quickly test a Gemini API key and model combination. Keys are never stored; they are used only for the one-off validation call.
- Visit Google AI Studio
- Click "Get API key" and choose a project
- Copy the generated key
- Configure it as
GOOGLE_GEMINI_API_KEYon Dev VM 220
This field is used only to call the /api/v1/ai/test endpoint. It is never written to disk.
If left blank, the backend will fall back to its default model (typically gemini-3.8-flash).
Model comparison
For portfolio analysis, Gemini 3.8 Flash is the pinned default: current stable function calling with a 1M token context. Use the rolling alias only when you want Google to move the model forward without a config change.
- 3.8 Flash: primary model for chat and AI Reports.
- 3.7 Flash: previous stable Flash model.
- 3.1 Pro (Preview): higher reasoning for heavier analysis. Preview behavior can change.
- Flash Latest: rolling alias. It is not the production default.
Currently testing with gemini-3.8-flash (Gemini 3.8 Flash (Recommended)).