@circuit-llm/node

Join and manage a Circuit mesh node from code: the inference-mesh control plane (register / ready / heartbeat) and the public node registry (announce / ping). The heavy GPU serving stays in the node image.

Part of the Circuit SDK. Contribute a node →

Install

npm install @circuit-llm/node

Usage

import { MeshControl, generateMeshIdentity } from '@circuit-llm/node';

const identity = generateMeshIdentity();
const mesh = new MeshControl({ controlUrl: 'http://control:18932', identity });
const { assignment } = await mesh.register({
  endpoint: ['1.2.3.4', 5000],
  capacityLayers: 40,
  modelFp: 'qwen2.5-72b-awq',
});
await mesh.ready();   // …then heartbeat

Also: NodeRegistry (public announce/ping) and signMeshBody / verifyMeshBody. Pair with @circuit-llm/onchain to verify what's staked.