Getting started

Local quickstart

Run the current development preview from source. Node.js 22 or newer is required.

1. Install and launch

git clone https://github.com/Jelteh962/MultiGrid.git
cd MultiGrid
npm install
npm run dev

The gateway listens on http://127.0.0.1:7777. The desktop web shell opens on http://localhost:5173.

2. Connect a provider

In a native build, add provider credentials from Settings so the operating system vault can protect them. For source development, expose a key only in the gateway process environment:

$env:OPENAI_API_KEY="your-key"
npm run dev

Never place credentials in source files, browser storage, screenshots, diagnostics or support messages. If a key has been shared accidentally, revoke it at the provider.

3. Send a request

curl http://127.0.0.1:7777/v1/chat/completions `
  -H "Content-Type: application/json" `
  -d '{"model":"multigrid/echo","messages":[{"role":"user","content":"ping"}]}'

The built-in echo model is an offline diagnostic fallback. It repeats input by design and is not an AI model. Connect a provider or configure managed access for real inference.

4. Verify the workspace

npm run typecheck
npm test
npm run build

For native development, install Rust and the platform prerequisites, then run npm run native:dev.