Skip to content

BuiltByEcho/plumb

Repository files navigation

Plumb

Verifiable AI infrastructure for high-stakes systems.

Plumb is a full-stack, self-hostable AI platform that turns model calls into auditable infrastructure: signed inference responses, model artifacts pinned by hash, credit billing, on-chain receipts, a model hub, SDKs, and operator-facing consoles.

Live: https://plumbtech.xyz

Built by Echo with Dustin as operator.

Why it matters

AI products are moving into workflows where “trust me, the model said so” is not enough. Plumb gives teams a way to prove what model was used, what response was returned, who paid for it, and where the verification trail lives.

What it includes

  • OpenAI-compatible gateway — drop-in /v1/chat/completions style API.
  • Signed inference receipts — every response can be verified independently.
  • On-chain settlement/checkpoints — Base Sepolia contracts for receipts, deposits, and registry state.
  • Credit billing — SIWE auth, deposits, balances, and metered usage.
  • Model Hub — upload, hash, register, and reference model artifacts.
  • Explorer + Console — product surfaces for inspecting receipts and managing usage.
  • Python SDK — developer client for integrating Plumb into apps and agents.
  • Security hardening — audit pass, critical fixes, and E2E validation across the stack.

Screenshots

Landing page

Plumb hero

How Plumb works

How it works

Live receipts

Live receipts

Receipt explorer

Receipt explorer

Console login

Console login

Product docs

Docs

Architecture

apps/
  gateway/      Hono API, auth, billing, inference, receipts
  worker/       async jobs, settlement, batch processing
  web/          public marketing + docs site
  console/      operator/customer dashboard
  explorer/     public receipt explorer
  sdk-python/   Python SDK package

packages/
  contracts/    Foundry contracts on Base Sepolia
  db/           Drizzle schema + migrations
  auth/         SIWE/session helpers
  billing/      credits, prices, balances
  providers/    model provider adapters
  verification/ receipt signing + verification
  hub-storage/  model artifact storage
  memsync/      memory/profile sync primitives

Tech stack

  • TypeScript monorepo, pnpm, Biome
  • Hono API gateway
  • Next.js web, console, and explorer apps
  • Drizzle + Postgres + pgvector
  • Foundry smart contracts
  • Base Sepolia deployment
  • Python SDK
  • Vercel + VPS deployment split

Local development

pnpm install
pnpm lint
pnpm -r typecheck
pnpm test

Environment variables are intentionally not committed. Use .env.example files and package-specific docs as references.

Project status

All planned product phases were implemented through the audit/hardening pass. The public site, docs, gateway, console, explorer, contracts, and SDK all exist in this repository.

About

Verifiable AI platform with signed inference and on-chain receipts

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors