FrameWorks

Warning: This stack is pre‑release and experimental. Do not deploy to production. Interfaces and schemas change frequently. Use for local development and evaluation only.

Sovereign SaaS for live video. Run on your infrastructure, ours, or both—no vendor lock-in.

An open streaming stack for live video: apps, real‑time APIs, and analytics. Services are narrowly scoped. Frontend uses GraphQL; service-to-service uses HTTP/gRPC APIs; analytics and realtime use Kafka events. Each service owns its data (no cross‑DB access).

Packages & Bundles

Package	Version
@livepeer-frameworks/player-react
@livepeer-frameworks/player-svelte
@livepeer-frameworks/player-core
@livepeer-frameworks/streamcrafter-react
@livepeer-frameworks/streamcrafter-svelte
@livepeer-frameworks/streamcrafter-core

Bundle	Size
marketing
docs
webapp client
webapp server

Architecture at a glance

• Gateway
  • Bridge (api_gateway): GraphQL gateway, aggregates all services
• Control plane (business logic)
  • Commodore (api_control): auth, streams, business logic
  • Quartermaster (api_tenants): tenants, clusters, nodes
  • Purser (api_billing): usage, invoices, payments
• Data plane (events & analytics)
  • Periscope Ingest (api_analytics_ingest): consumes Kafka, writes ClickHouse
  • Periscope Query (api_analytics_query): serves analytics & usage summaries
  • Decklog (api_firehose): gRPC ingress → Kafka
  • Kafka: event backbone
  • PostgreSQL: state & aggregates
  • ClickHouse: time‑series
• Media plane
  • Foghorn (api_balancing): regional load balancer & media pipeline orchestrator (HA via Redis, cross-cluster federation via FoghornFederation gRPC)
  • Helmsman (api_sidecar): edge sidecar, MistServer management via Foghorn
  • MistServer: ingest/processing/edge delivery
  • Livepeer Gateway (golivepeer): transcoding/AI processing
• Network & Infrastructure
  • Navigator (api_dns): public DNS automation & certificate issuance
  • Privateer (api_mesh): WireGuard mesh agent & local DNS
• AI
  • Skipper (api_consultant): AI video consultant with RAG, tool-use, and SSE streaming
• Realtime
  • Signalman (api_realtime): WebSocket hub for live updates
• Interfaces
  • Web Console (website_application): main dashboard
  • Marketing Site (website_marketing): public site
  • Documentation (website_docs): Astro Starlight docs
  • Forms API (api_forms): contact forms, newsletter (Listmonk)

Principles

• Strict service boundaries (no cross‑DB reads)
• Time‑serie/data-plane in ClickHouse; control/aggregates in Postgres
• Type safety by reusing the gRPC types straight from the emitter. Passthrough and leave source data intact as much as possible, with optional enrichment fields

Quick Start

Development Setup (docker-compose)

For local development and testing:

git clone https://github.com/Livepeer-FrameWorks/monorepo.git
cd monorepo
cp config/env/secrets.env.example config/env/secrets.env  # edit values as needed
make env  # writes .env from config/env
docker-compose up

The Compose stack loads ${ENV_FILE:-.env} automatically. Override ENV_FILE (and pass --env-file to docker compose) when you want to use a different generated env file (for example .env.staging).

Endpoints (local)

• GraphQL Gateway: http://localhost:18090/graphql
• GraphQL WebSocket: ws://localhost:18090/graphql/ws (subscriptions)
• App via Nginx: http://localhost:18090
• Web Console: http://localhost:18030
• Marketing site: http://localhost:18031
• Listmonk (Admin): http://localhost:9001
• MistServer: http://localhost:4242 (RTMP: 1935, HTTP: 8080)
• Kafka (external): localhost:29092
• Postgres: localhost:5432
• ClickHouse: 8123 (HTTP), 9000 (native)

Building & Testing

All build and test commands go through the Makefile. Key targets:

Target	Description
make build	Build all service binaries
make test	Run all tests (with race detector)
make lint	Run Go + frontend lint checks (matches CI lint jobs)
make ci-local	Run main CI checks locally (go/frontend lint, test, build)
make verify	Full verification (tidy, fmt, vet, test, build)
make env	Generate .env from config/env/

Single service: make build-bin-<name> (e.g. make build-bin-purser). See Makefile for all targets.

Ports

Plane	Service	Port	Notes
Gateway	Bridge	18000	GraphQL Gateway
Control	Commodore	18001	Health/Metrics
Control	Commodore (gRPC)	19001	gRPC API
Control	Quartermaster	18002	Health/Metrics
Control	Quartermaster (gRPC)	19002	gRPC API
Control	Purser	18003	Health/Metrics
Control	Purser (gRPC)	19003	gRPC API
Data	Periscope Query	18004	HTTP health/metrics only
Data	Periscope Query (gRPC)	19004	gRPC API
Data	Periscope Ingest	18005	Kafka consumer
Data	Decklog	18006	gRPC
Data	Decklog (metrics)	18026	Prometheus metrics
Data	Kafka (external)	29092	Host access
Data	Kafka (internal)	9092	Cluster access
Data	Zookeeper	2181	Kafka coordination
Data	PostgreSQL	5432	Primary database
Data	ClickHouse (HTTP)	8123	Analytics database
Data	ClickHouse (Native)	9000	Analytics database
Network	Navigator	18010	Public DNS management & ACME
Network	Navigator (gRPC)	18011	gRPC API
Network	Privateer	18012	WireGuard mesh agent & Local DNS
Media	Helmsman	18007	Edge API
Media	Foghorn	18008	Balancer
Media	Foghorn (control)	18019	gRPC control API + FoghornFederation (cross-cluster peering)
Media	Foghorn Redis	6379	Foghorn state sync (HA). Separate from Chatwoot Redis
Media	MistServer (control)	4242	Control API
Media	MistServer (RTMP)	1935	Ingest
Media	MistServer (HTTP)	8080	HLS/WebRTC delivery
Media	MistServer (SRT)	8889/udp	SRT ingest
Media	Livepeer Gateway (CLI)	18016	golivepeer control (compute gateway; integration WIP; not in dev compose)
Media	Livepeer Gateway (RPC/HTTP)	18017	golivepeer public API (compute gateway; integration WIP; not in dev compose)
Realtime	Signalman	18009	WebSocket hub
Realtime	Signalman (gRPC)	19005	gRPC API
Support	Nginx	18090	Reverse proxy
Support	Prometheus	9091	Metrics (CLI deployment only)
Support	Grafana	3000	Dashboards (CLI deployment only)
Support	Metabase	3001	BI Analytics (CLI deployment only)
Support	Listmonk	9001	Newsletter Admin
Support	Chatwoot	18092	Support dashboard (via Nginx: /support)
UI	Web Console	18030	Application UI
UI	Marketing Site	18031	Public site
UI	Documentation	18033	Starlight docs
Support	Forms API	18032	Contact forms
Deferred	Lookout (api_incidents)	18013	Incident management (use Prometheus/Grafana instead)
Planned	Parlor (api_rooms)	18014	Channel rooms for interactive features
Support	Deckhand (api_ticketing)	18015	Support ticketing
Support	Deckhand (gRPC)	19006	Support gRPC API
AI	Skipper	18018	AI video consultant HTTP
AI	Skipper (gRPC)	19007	gRPC API

Documentation

Public docs: logbook.frameworks.network (source: website_docs/)

Audience	Covers
Streamers	Quick start, encoder setup, API reference, playback
Operators	Architecture, deployment, DNS, CLI, multi-cluster, WireGuard
Selfhosted	Self-hosted edge nodes with enrollment tokens
Agents	MCP integration, wallet auth, x402 payments

Internal docs (in-repo, for contributors):

Directory	Purpose
docs/architecture/	System design decisions (analytics, routing, …)
docs/standards/	Design system, metrics naming, testing policy
docs/rfcs/	Proposals under discussion
docs/skills/	Agent integration & discovery files
CONTRIBUTING.md	Dev setup, code style, workflows, PR process