Installation

Requirements

• Node.js 22 or newer, with pnpm
• A model API key (OpenRouter by default) — only if you enable the Ask AI assistant

Install

pnpm

pnpm install
pnpm build

npm

npm install
npm run build

Enabling Ask AI

The assistant runs inside the docs server itself: an agentic loop that searches, greps, and reads your pages before answering. Enabling it takes one config file and one environment variable.

models.toml sits next to docs.json and names the model; the key comes from the environment:

export OPENROUTER_API_KEY=sk-or-...
graphstaff dev

Warning:

The model API key lives only in the server’s environment. It never appears in docs.json, the built site, or the browser.

Deploying without Ask AI

Skip the key entirely. The site builds to a static dist/ folder that works on any static host; the Ask AI modal shows a plain “not configured” notice and keyword search covers lookup.