Skip to main content

Work from a source checkout

Use this path for runtime development, local control-plane tests, and physical deployment experiments. Product users should prefer the native installer.

Prerequisites​

  • Node.js 24 or later.
  • npm from the Node.js installation.
  • Python 3.12 for the physical runtime.
  • PowerShell for the included Windows orchestration scripts.

Install and validate​

npm ci
npm run typecheck
npm run build
npx vitest run --testTimeout=30000

Run the synthetic control-plane demo​

npm run demo

This starts a coordinator and worker, performs one complete synthetic request, and prints the resulting tokens and network metrics.

Run coordinator and worker separately​

Start the coordinator:

npm run dev:coordinator

In another PowerShell terminal, start a configured worker:

$env:GPU_MESH_WORKER_CONFIG = ".\config\worker.example.json"
$env:GPU_MESH_COORDINATOR = "http://127.0.0.1:8787"
npm run dev:worker

The example worker is a development fixture. A physical claim requires a real runtime backend, measured hardware evidence, and a passing generation canary.

Before changing the runtime​

The repository contains internal design and experiment documents that evolve faster than this public manual. Start with docs/00_WIKI.md inside the checkout to identify the current canonical engineering documents and the live execution checklist.

Last updated on