Environment variables

Model endpoints

Variable Purpose
OPENAI_BASE_URL Planner API base (default http://localhost:8080)
OPENAI_API_KEY Planner API key
OPENAI_MODEL Planner model id
NINJA_SUBAGENT_BASE_URL Default subagent base
NINJA_SUBAGENT_API_KEY Default subagent key
NINJA_SUBAGENT_MODEL Default subagent model

Prefer NINJA_SUBAGENT_* for workers. Older legacy names may still work for compatibility.

Tool / integration keys

Variable Purpose
NINJA_SERPER_API_KEY Web search (preferred)
SERPER_API_KEY Web search (fallback)

Install (optional)

Variable Purpose
NINJA_VERSION Pin version when using install.sh
NINJA_CDN_BASE Force install CDN origin

Precedence

Non-empty environment variables override config.json for that shell.

OPENAI_MODEL=other-model ninja