Documentation Index
Fetch the complete documentation index at: https://na-36-handover-docs-v2-into-docs-v2-dev-20260518.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
The Livepeer GitHub organisation hosts over 170 public repositories. This page groups the ones developers actually touch by the network layer they belong to, and tags each one as [Official] (maintained under the livepeer/ organisation), [Community] (maintained by ecosystem contributors), or [Archived] (no longer maintained).
For why each layer exists, see . For where each persona enters the stack, see .
Core Runtime Repositories
Every Livepeer network role runs from one of these binaries. Every other layer in the stack depends on or connects to them.
| Repo | Tag | Role | Language |
|---|
| livepeer/go-livepeer | Official | Reference node: orchestrator, gateway, transcoder, broadcaster | Go |
| livepeer/ai-runner | Official | Containerised inference runtime; go-livepeer spawns one per GPU pipeline | Python |
| livepeer/lpms | Official | Media-processing primitives over FFmpeg; transcoding and codec operations | Go |
| livepeer/ai-worker | Official | AI runner client and OpenAPI spec consumed by go-livepeer | Python |
| livepeer/catalyst | Official | Decentralised media server; handles ingest and segment upload | Go |
| livepeer/task-runner | Official | Background task executor for hosted-Solution VOD workflows | Go |
go-livepeer is the foundation. When AI inference is enabled, it spawns ai-runner Docker containers per GPU and proxies inference requests via a local REST interface. lpms is the media-processing library it uses for transcoding.
On-Chain Protocol Repositories
Cryptoeconomic contracts deployed on Arbitrum One. go-livepeer calls these for all on-chain operations.
| Repo | Tag | Role | Language |
|---|
| livepeer/protocol | Official | Solidity contracts: staking, bonding, reward distribution, settlement, treasury | Solidity |
| livepeer/arbitrum-lpt-bridge | Official | Bridge contracts moving LPT between Ethereum L1 and Arbitrum One | Solidity, TypeScript |
| livepeer/LIPs | Official | Livepeer Improvement Proposals: canonical record of accepted changes | Markdown |
The confluence branch of livepeer/protocol is the deployed Arbitrum version. The streamflow branch covers the L1 contracts (LivepeerToken and BridgeMinter only; all other core protocol contracts are paused on L1).
Gateway API Surface
REST APIs and operator tooling that sit on top of go-livepeer.
| Repo / Surface | Tag | Role | Notes |
|---|
| AI Gateway API | Official | REST API for direct AI inference. Two hosted providers: the Studio Gateway (paid) and the Cloud Community Gateway at dream-gateway.livepeer.cloud (free, off-chain) | |
| livepeer/naap | Official | Network-as-a-Platform; Next.js 15 micro-frontend portal shell for AI Compute operators. Ships with 12 core plugins | operator.livepeer.org |
| eliteprox/pymthouse | Community | Hosted identity, billing, and signer-proxy infrastructure for Livepeer-powered apps. OIDC provider, RFC 8693 token exchange, managed remote-signer proxy | pymthouse.com |
The internal livepeer-data-mcp server is not a developer surface. It backs internal operations only.
Real-Time Pipeline Repositories
Live-video-to-video workflows, BYOC containers, trickle transport.
| Repo | Tag | Role | Language |
|---|
| livepeer/comfystream | Official | ComfyUI custom-node package that turns workflows into real-time video pipelines | Python |
| livepeer/ComfyUI-Stream-Pack | Official | StreamDiffusion and related custom nodes for real-time AI video | Python |
| livepeer/pytrickle | Official | Python SDK for the trickle streaming protocol; FrameProcessor base class for BYOC | Python |
| muxionlabs/byoc-example-apps | Community | Reference BYOC pipelines: image upscale, audio inference, custom transforms | Python, TypeScript |
| muxionlabs/byoc-sdk | Community | TypeScript SDK for building BYOC containers and submitting jobs | TypeScript |
| muxionlabs/livepeer-app-pipelines | Community | Reference application pipelines that compose multiple BYOC capabilities | Mixed |
ComfyStream sits above ai-runner on the real-time path and uses pytrickle to exchange frames with an orchestrator. A BYOC developer using pytrickle directly implements the same FrameProcessor interface that ComfyStream uses internally.
Application SDK Repositories
Client libraries for calling the network from an application.
| Repo | Tag | Role | Language |
|---|
| livepeer/livepeer-ai-js | Official | JavaScript and TypeScript SDK for the AI Gateway API | TypeScript |
| livepeer/livepeer-ai-python | Official | Python SDK for the AI Gateway API; Speakeasy-generated | Python |
| livepeer/ui-kit | Official | React component library: <Player.Root>, <Broadcast.Root>, WebRTC/HLS, accessibility | TypeScript, React |
| j0sh/livepeer-python-gateway | Community | Python implementation of a Livepeer gateway. OrchestratorSession, PaymentSession, StartJobRequest | Python |
livepeer-js and ui-kit refer to the same active repository. The historical livepeer-js namespace redirects to ui-kit.
Agent and Creative Repositories
Agent SDKs and frameworks built on top of the network. Some packages are not yet published to npm.
| Repo | Tag | Role | Status |
|---|
| livepeer/storyboard | Official | Agent-powered creative workspace at storyboard-rust.vercel.app. Orchestrates 40 AI models | Live |
@livepeer/agent (in storyboard monorepo) | Official | Provider-agnostic agent runtime. Gemini, Claude, OpenAI, Livepeer | Not on npm |
@livepeer/creative-kit (in storyboard monorepo) | Official | Canvas state, command router, capability resolver, UI components | Not on npm |
The two SDK packages live inside the storyboard monorepo until they ship on npm. Clone the repo to use them today.
Monitoring Repositories
Operator observability; mostly community-maintained.
| Repo | Tag | Role | Maintainer |
|---|
| livepeer/livepeer-monitoring | Official | Prometheus exporters and Grafana dashboards for go-livepeer | Livepeer Inc |
| transcodeninja/livepeer-exporter | Community | Enhanced Prometheus exporter with additional signal coverage | transcodeninja |
| rickstaa/livepeer-reward-watcher | Community | Alerts when an orchestrator is at risk of missing a reward call | rickstaa |
| Stronk-Tech ecosystem | Community | Suite of operator tools: OrchestratorTracker, LivepeerPerformanceAI, LivepeerExplorer, StronkAI | Captain Stronk |
Governance Repositories
Async governance and async-first coordination.
| Repo | Tag | Role |
|---|
| livepeer/LIPs | Official | Livepeer Improvement Proposals |
| livepeer/coordination | Official | Async-first governance coordination via GitHub issues |
| livepeer/roadmap | Official | Community-visible roadmap using GitHub Projects |
Documentation and Discovery Repositories
| Repo | Tag | Role |
|---|
| livepeer/docs | Official | This documentation site. MDX, Mintlify |
| livepeer/awesome-livepeer | Community | Curated list of projects, tutorials, demos. Also at livepeer.cool |
Solutions Repositories
Hosted products built on the network. Documented under ; listed here for completeness.
| Repo | Tag | Role |
|---|
livepeer/studio | Official [Solution; see Solutions tab] | Full Studio monolith: auth, billing, API keys, multistream, recording, signing keys, metrics |
| Daydream | Official [Solution; see Solutions tab] | Hosted real-time AI video API and consumer app, built on ComfyStream |
Layer Dependencies
The stack is a dependency chain. Every layer above depends on the layers below it; each layer can be accessed directly without building at the layers above.
go-livepeer is the foundation. Every other official repository either depends on it, generates clients for its APIs, or provides tooling around it.
ai-runner is spawned by go-livepeer per GPU per pipeline. go-livepeer generates its Go client bindings from ai-runner’s OpenAPI spec via make ai_worker_codegen.
comfystream and pytrickle sit above ai-runner on the real-time path. comfystream uses pytrickle’s trickle protocol to exchange frames with an orchestrator. A BYOC developer using pytrickle directly implements the same FrameProcessor interface.
The AI Gateway API is the standard REST interface that all SDK consumers reach through. Calling livepeer-ai-js or livepeer-ai-python sends requests to a gateway node, which routes them through go-livepeer to the relevant orchestrators.
ui-kit is independent of the AI and protocol path. It provides Player and Broadcast components for browser applications and works against any compatible gateway.
Contribution Entry Points
| If you want to work on… | Start here |
|---|
| AI pipelines (batch inference, new pipeline types) | livepeer/ai-runner; open issues, runner/pipelines/ modules |
| Real-time AI (ComfyStream, BYOC, trickle transport) | livepeer/comfystream or livepeer/pytrickle; open issues, #comfystream Discord |
| Core node (gateway, orchestrator, transcoder logic) | livepeer/go-livepeer; contributing guide in README |
| Smart contracts (staking, bonding, governance) | livepeer/protocol; open issues |
| Frontend SDK (player, React components) | livepeer/ui-kit; open issues, #developers Discord |
| Documentation | livepeer/docs; branch docs-v2-dev, contribution guide |
covers the broader process.