Skip to main content
All configuration is done via a .env file in the project root, or via real environment variables at runtime. Variables defined in the environment take precedence over .env.

​
Variables

​
GEMINI_PROXY_URL
string
default:"http://127.0.0.1:8000/v1/chat/completions"
required
The OpenAI-compatible endpoint URL of your Gemini Proxy Balancer. All LLM requests are routed through this URL.
GEMINI_PROXY_URL=https://your-proxy.up.railway.app/v1/chat/completions
​
OBSIDIAN_VAULT_PATH
string
required
Absolute path to your Obsidian vault directory. Second Brain reads and writes all notes relative to this path.
OBSIDIAN_VAULT_PATH=/Users/you/Documents/MyVault
On Railway deployments, vaults are typically stored under /app/obsidian-vaults.
​
GEMINI_MODELS
string
Comma-separated list of Gemini model IDs in priority order. The first model in the list is used by default. Provide multiple models to enable fallback if a model is unavailable.
GEMINI_MODELS=gemini-2.5-flash,gemini-2.0-flash-lite
​
GEMINI_MAX_ROUNDS
integer
default:"3"
Maximum number of agent reasoning rounds per task. Each round is one full Manager → Agent → Manager cycle. Increase this for complex tasks that require more back-and-forth between agents.
GEMINI_MAX_ROUNDS=5
​
LOG_LEVEL
string
default:"INFO"
Logging verbosity. Accepted values: DEBUG, INFO, WARNING, ERROR.
LOG_LEVEL=DEBUG
​
WORKSPACE_DIR
string
default:".workspace"
Directory for workspace vaults created inside the app. This is relative to the project root unless you provide an absolute path.
WORKSPACE_DIR=.workspace
​
LOGS_DIR
string
default:"logs"
Directory for log files. Relative to the project root unless an absolute path is provided.
LOGS_DIR=logs

​
Example .env

.env
# Required
GEMINI_PROXY_URL=https://your-proxy.up.railway.app/v1/chat/completions
OBSIDIAN_VAULT_PATH=/Users/you/Documents/MyVault

# Model selection
GEMINI_MODELS=gemini-2.5-flash,gemini-3-flash-preview,gemini-3.1-flash-lite-preview,gemini-2.0-flash-lite,gemini-3.1-flash-live-preview,gemini-flash-latest

# Pipeline behaviour
GEMINI_MAX_ROUNDS=3

# Logging
LOG_LEVEL=INFO

# Directories
WORKSPACE_DIR=.workspace
LOGS_DIR=logs
OBSIDIAN_VAULT_PATH can also be set from within the app UI — open or create a vault in the Vault Launcher and the path is persisted automatically to your .env file.