Skip to main content

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.
RepoTagRoleLanguage
livepeer/go-livepeerOfficialReference node: orchestrator, gateway, transcoder, broadcasterGo
livepeer/ai-runnerOfficialContainerised inference runtime; go-livepeer spawns one per GPU pipelinePython
livepeer/lpmsOfficialMedia-processing primitives over FFmpeg; transcoding and codec operationsGo
livepeer/ai-workerOfficialAI runner client and OpenAPI spec consumed by go-livepeerPython
livepeer/catalystOfficialDecentralised media server; handles ingest and segment uploadGo
livepeer/task-runnerOfficialBackground task executor for hosted-Solution VOD workflowsGo
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.
RepoTagRoleLanguage
livepeer/protocolOfficialSolidity contracts: staking, bonding, reward distribution, settlement, treasurySolidity
livepeer/arbitrum-lpt-bridgeOfficialBridge contracts moving LPT between Ethereum L1 and Arbitrum OneSolidity, TypeScript
livepeer/LIPsOfficialLivepeer Improvement Proposals: canonical record of accepted changesMarkdown
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 / SurfaceTagRoleNotes
AI Gateway APIOfficialREST 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/naapOfficialNetwork-as-a-Platform; Next.js 15 micro-frontend portal shell for AI Compute operators. Ships with 12 core pluginsoperator.livepeer.org
eliteprox/pymthouseCommunityHosted identity, billing, and signer-proxy infrastructure for Livepeer-powered apps. OIDC provider, RFC 8693 token exchange, managed remote-signer proxypymthouse.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.
RepoTagRoleLanguage
livepeer/comfystreamOfficialComfyUI custom-node package that turns workflows into real-time video pipelinesPython
livepeer/ComfyUI-Stream-PackOfficialStreamDiffusion and related custom nodes for real-time AI videoPython
livepeer/pytrickleOfficialPython SDK for the trickle streaming protocol; FrameProcessor base class for BYOCPython
muxionlabs/byoc-example-appsCommunityReference BYOC pipelines: image upscale, audio inference, custom transformsPython, TypeScript
muxionlabs/byoc-sdkCommunityTypeScript SDK for building BYOC containers and submitting jobsTypeScript
muxionlabs/livepeer-app-pipelinesCommunityReference application pipelines that compose multiple BYOC capabilitiesMixed
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.
RepoTagRoleLanguage
livepeer/livepeer-ai-jsOfficialJavaScript and TypeScript SDK for the AI Gateway APITypeScript
livepeer/livepeer-ai-pythonOfficialPython SDK for the AI Gateway API; Speakeasy-generatedPython
livepeer/ui-kitOfficialReact component library: <Player.Root>, <Broadcast.Root>, WebRTC/HLS, accessibilityTypeScript, React
j0sh/livepeer-python-gatewayCommunityPython implementation of a Livepeer gateway. OrchestratorSession, PaymentSession, StartJobRequestPython
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.
RepoTagRoleStatus
livepeer/storyboardOfficialAgent-powered creative workspace at storyboard-rust.vercel.app. Orchestrates 40 AI modelsLive
@livepeer/agent (in storyboard monorepo)OfficialProvider-agnostic agent runtime. Gemini, Claude, OpenAI, LivepeerNot on npm
@livepeer/creative-kit (in storyboard monorepo)OfficialCanvas state, command router, capability resolver, UI componentsNot 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.
RepoTagRoleMaintainer
livepeer/livepeer-monitoringOfficialPrometheus exporters and Grafana dashboards for go-livepeerLivepeer Inc
transcodeninja/livepeer-exporterCommunityEnhanced Prometheus exporter with additional signal coveragetranscodeninja
rickstaa/livepeer-reward-watcherCommunityAlerts when an orchestrator is at risk of missing a reward callrickstaa
Stronk-Tech ecosystemCommunitySuite of operator tools: OrchestratorTracker, LivepeerPerformanceAI, LivepeerExplorer, StronkAICaptain Stronk

Governance Repositories

Async governance and async-first coordination.
RepoTagRole
livepeer/LIPsOfficialLivepeer Improvement Proposals
livepeer/coordinationOfficialAsync-first governance coordination via GitHub issues
livepeer/roadmapOfficialCommunity-visible roadmap using GitHub Projects

Documentation and Discovery Repositories

RepoTagRole
livepeer/docsOfficialThis documentation site. MDX, Mintlify
livepeer/awesome-livepeerCommunityCurated list of projects, tutorials, demos. Also at livepeer.cool

Solutions Repositories

Hosted products built on the network. Documented under ; listed here for completeness.
RepoTagRole
livepeer/studioOfficial [Solution; see Solutions tab]Full Studio monolith: auth, billing, API keys, multistream, recording, signing keys, metrics
DaydreamOfficial [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
Documentationlivepeer/docs; branch docs-v2-dev, contribution guide
covers the broader process.
Last modified on May 19, 2026