Livepeer Modules Suite

An umbrella repository that aggregates the Livepeer Modules — the productized features that enable the Livepeer protocol — as git submodules, and provides a single high-level overview of the whole suite and how its parts fit together.

This repo holds documentation and submodule pointers, not module source code. Each module's code lives in its own repository under modules/.

Start here

• AGENTS.md — the map: what this repo is and where everything lives.
• ARCHITECTURE.md — how a unit of work flows across the suite.
• docs/glossary.md — shared vocabulary.
• docs/product-specs/ — one overview per capability.
• docs/repos/ — one doc per onboarded submodule.
• docs/guides/git-submodules-primer.md — how to clone, update, and pin submodules to network releases.

The capabilities

Gateways · Orchestrators · Runners · Pools · Payment · Service Registry · Discover · Payment Clearinghouse (+ SDKs) · Reference Apps. See docs/product-specs/index.md for status.

Onboarded repos

• livepeer-network-modules — the supply-side core (workload-agnostic capability broker + payment, pools, registry, discovery, protocol, trust spine). The first abstraction layer over the smart contracts.
• livepeer-open-clearinghouse — the demand-side, non-custodial Payment Clearinghouse (auth, prepaid credit, mint-on-behalf, handoff-mode jobs/sessions). Consumes the network-modules daemons.
• livepeer-modules-openai-runners — containerized AI Runner backends (chat, embeddings, audio, TTS, image, rerank) that sit behind the capability broker.
• livepeer-modules-transcode-runners — video Runner backends (VOD transcode, ABR ladder, live RTMP→HLS) with NVIDIA/Intel/AMD support.
• livepeer-modules-transcode-gateway — a full in-path video Gateway (VOD ABR + live RTMP→HLS) with a thin SaaS shell; route selection/payment flow through LOC.
• livepeer-modules-openai-gateway — a full in-path OpenAI-compatible AI Gateway ("change base_url"); the LOC-mediated AI twin of the transcode-gateway, fronting the openai-runners.

Observability & Reporting (off-network — tracks on-chain activity):

• livepeer-protocol-explorer — a Rust data platform that indexes, prices (per-block, deterministic), and serves Livepeer on-chain activity via an HTTP API + web explorer.
• livepeer-network-bot — a Discord bot that reports payouts and activity by polling the protocol explorer's API.

Getting the code

git clone --recurse-submodules <this-repo-url>
# or, if already cloned:
git submodule update --init --recursive

How this repo is organized

It follows an agent-first, documentation-as-system-of-record approach (see docs/references/openai-harness-engineer.md for the inspiration): a short map (AGENTS.md) points into a structured docs/ directory, and every claim is meant to be verifiable in-repo. Operating principles are in docs/design-docs/core-beliefs.md.

Status: eight repos onboarded. Network supply, clearinghouse, AI/video runners, AI/video gateways, and off-network observability are documented from pinned submodules; daydream gateway, vtuber runners, and Reference Apps still await their own repos.