Build console

lightnode CLI

Bundled in lightnode-sdk. Read-only commands run inline below; the rest run from your terminal. Eleven add scaffolders patch an existing project - six server-paid, the user-paid web3 trio, wagmi-setup, and the code-first worker-operator console.

How to run these in your terminal

The npm package is lightnode-sdk but the bundled binary is named lightnode, which clashes with another package on npm. Three reliable invocations:

# One-shot (explicit package):
npx --package=lightnode-sdk -- lightnode wallet new

# Install in your project, then npx finds it:
npm install lightnode-sdk
npx lightnode wallet new

# Global install for everyday use:
npm install -g lightnode-sdk
lightnode wallet new

Try a command (no install)

Pick a read-only command on the left, hit Run, see real JSON. Same output the CLI would print.

interactiveRun a CLI command from the browser

Network summary: totals, active workers, jobs, earnings, model count.

lightnode network --net mainnet

Click Run. The output appears below; it's the same JSON the CLI would print.

add (writes files in your project)

lightnode add inferenceServer-paid. Encrypted inference route or script. Next.js: app/api/inference/route.ts. Hono / Node: lightchain-inference.ts.
lightnode add chatServer-paid. Chat UI with conversation history. Next.js: app/chat/page.tsx. Node: terminal REPL with rolling memory.
lightnode add judgeServer-paid. Pass/fail evaluator route - post criteria + evidence, get structured verdict + on-chain proof.
lightnode add agentServer-paid. Scheduled / loop inference. Next.js: Vercel Cron route + vercel.json. Node: long-running setInterval daemon.
lightnode add analytics-dashboardRead-only network + worker analytics page. No wallet, no fees. Next.js: SSR page; Node: CLI script.
lightnode add nft-mint-with-inferenceAI-generated NFT metadata with on-chain provenance. Mint flow that anchors the answer to a content hash.
lightnode add inference-web3User-paid. One-shot inference UI, wallet-signed. Scaffolds Next.js, bundles wagmi + Connect button, and installs deps - one command. No backend, no .env.
lightnode add chat-web3User-paid. Chat UI, wallet-signed (mainnet + testnet aware). Scaffolds Next.js, bundles wagmi + Connect button, wires the layout, installs deps - one command. Each turn is one SIWE sig + one tx.
lightnode add judge-web3User-paid. Evaluator UI, wallet-signed. Scaffolds Next.js, bundles wagmi + Connect button, and installs deps - one command. Criteria + evidence in, PASSED/FAILED + on-chain receipt out.
lightnode add wagmi-setupWallet wiring on its own: lib/wagmi + app/providers + a connect button, and it wraps your layout with <Providers>. Bundled automatically by the web3 scaffolders. Add --no-install / --no-scaffold to opt out.
lightnode add worker-operatorWorker-operator. A runnable Node console (worker-ops.ts) over the WorkerOperator surface - status / settle / clearstuck / withdraw / deregister / profitability, no Docker or worker image. status prints JSON (todo[] + outOfGas) for cron.

All add commands accept --template auto|nextjs-api|hono|node, --net testnet|mainnet, and --force.

Inferences + wallet (need PRIVATE_KEY)

lightnode chat <prompt>One-shot encrypted inference. Streams answer to stdout, JSON receipt to stderr. Supports stdin too.
lightnode batch <prompts.json>Parallel inference. Reads JSON array or {prompts, system?, model?}; one JSON line per result to stdout. Supports - for stdin and --concurrency 4.
lightnode agent <task>ReAct-style agent with built-in add + now tools. Streams the step trace to stderr, final answer to stdout. Cap with --max-iter 4.
lightnode wallet new|address|balanceGenerate a key, read the address of your env key, check balance on mainnet/testnet.
lightnode worker preflightSubmits ONE real test inference and prints a verdict. Useful as a CI gate.
lightnode worker watch <addr>Polls a worker, emits JSON line on state change (no key required).
lightnode worker status|can-deregister|settle|clearstuck|withdraw|deregisterThe worker-operator lifecycle from the terminal. status and can-deregister are read-only; the rest sign with your key. clearstuck times out acked, past-deadline jobs that block the exit (mainnet realizes a slash, so it needs --yes).
lightnode bridge addressesPrint the LCAI bridge route (Ethereum <-> LightChain).
lightnode dao addresses|configLCAI Governor addresses + live voting delay/period/threshold.

# One-shot (explicit package): npx --package=lightnode-sdk -- lightnode wallet new # Install in your project, then npx finds it: npm install lightnode-sdk npx lightnode wallet new # Global install for everyday use: npm install -g lightnode-sdk lightnode wallet new