Skip to content

Configuration

CSPilot loads .env.cspilot from the current working directory.

CSPILOT_RUNS_DIR=runs
XTB_COMMAND=xtb
ORCA_COMMAND=/path/to/orca
NWPESSE_BIN=nwpesse
MACE_MODEL=/path/to/model.model

AGAPI_API_KEY=your_api_key
AGAPI_BASE_URL=https://atomgpt.org/api
cspilot_MODEL=openai/gpt-oss-20b

OPENROUTER_API_KEY=your_openrouter_key
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
OPENROUTER_MODEL=openai/gpt-oss-20b:free
CSPILOT_LLM_PROVIDER=openrouter

Implemented Variables

Variable Used by Default or requirement
CSPILOT_RUNS_DIR deterministic commands and fixed workflows runs
XTB_COMMAND xTB optimization xtb
ORCA_COMMAND ORCA CLI and workflows orca
NWPESSE_BIN NWPESSe workflow nwpesse
MACE_MODEL workflow mace-orca when --model is omitted fallback placeholder
AGAPI_API_KEY AGAPI model backend and AGAPI/JARVIS materials wrapper required only for --llm-provider agapi or AGAPI materials queries
AGAPI_BASE_URL OpenAI-compatible AGAPI client required only when AGAPI model serving is selected
cspilot_MODEL AGAPI model required only when AGAPI model serving is selected
OPENROUTER_API_KEY OpenRouter model backend required for default NLIP/model-backed commands
OPENROUTER_BASE_URL OpenRouter-compatible client https://openrouter.ai/api/v1
OPENROUTER_MODEL OpenRouter model openai/gpt-oss-20b:free
CSPILOT_LLM_PROVIDER search, agent, plan, run, graph-run, repair helper openrouter; use agapi to force AGAPI model serving

OPI may also recognize OPI_ORCA and ORCA_PATH internally. CSPilot CLI settings use ORCA_COMMAND.

Names Not Currently Read

Name Current status Use now
XTB_BIN not read XTB_COMMAND
ORCA_BIN not read ORCA_COMMAND
MULTIWFN_BIN planned only none
MACE_MODEL_PATH not read MACE_MODEL or --model

Work Directories

  • inspect, xtb-opt, orca-sp, mace-opt, and workflow ... create timestamped directories under CSPILOT_RUNS_DIR.
  • plan, execute, run, graph-run, agent, search, stk-*, and nwpesse-search accept explicit --workdir style paths.
  • run and graph-run write report files in their selected workdir.

Output Controls

run and graph-run support:

  • --pretty / --no-pretty: Rich terminal tables and panels, on by default.
  • --quiet: print only final status and report path.
  • --html: write final_report.html instead of final_report.md.