OpenResearch

CLI Environment Variables

The local orx dashboard stores compute credentials and workload secrets in ~/.openresearch/env. This keeps secrets out of repositories while making them available to workloads launched through the CLI.

Add a variable

Start the dashboard with orx up, then open Settings > Environment. Add each key and value there; saved values are masked when you return.

Common compute credentials

  • HF_TOKEN authorizes Hugging Face Jobs. A write-scoped token is required to launch jobs.
  • MODAL_TOKEN_ID and MODAL_TOKEN_SECRET authorize Modal compute.
  • Add any API keys or configuration that your remote workload needs at runtime.

Precedence

Variables already present in the environment where orx is running override values saved in ~/.openresearch/env.