Docs

Plumb is a self-hostable stack for verifiable AI inference, a content-addressed model hub, pgvector-backed memory, and a smart-contract-callable pipe oracle. Everything ships as a pnpm monorepo you can clone and run on a single VPS.

Where to go next

  • Quickstart — 5-minute Python onboard: SIWE login, mint test credits, run a completion, verify the receipt.
  • Python SDK — full client reference: chat, receipts, memsync, hub, pipe, verify_receipt.
  • API reference — every HTTP route on the gateway with auth, request/response shape, and status codes.
  • Contracts — deployed Base Sepolia addresses for PLMB, Settlement, HubRegistry, PipeOracle, PipeConsumer + ABI downloads.

Concepts

  • Session — SIWE-issued Bearer token. Replaces passwords; tied to your wallet address.
  • Credits — denominated in PLMB (1 PLMB = 1,000,000 micro-PLMB). Top up via Settlement.deposit() or the console.
  • Receipt — an ed25519-signed record of one completion. Verifiable locally; settled on-chain in batches.
  • Checkpoint — a Merkle root over a batch of receipts, written to Settlement.checkpointReceipts() on Base.
  • Hub model — a content-addressed (keccak256) upload. Registering it on-chain via HubRegistry pins the uploader as recipient.
  • Pipe job — an on-chain PipeOracle.request(modelHash, inputHash, callback) → off-chain worker fulfills and calls back.

Phase and version

Plumb is on public preview. Contracts are on Base Sepolia (chainId 84532). Mainnet-ready contract audits and the TEE-backed receipt mode are roadmap.