Livecho is an experimental, distributed real-time captioning system for public live streams. A trusted cloud service ingests one stream, while invited community workers perform speech recognition and a public web client renders the resulting timeline.
At the 2026-11-15 source baseline (c8ee4a1), the merged repository contains:
- Engineering foundation (#1), Alpha boundary records (#2), protocol v1 with deterministic Python/TypeScript verification (#3), and an offline fail-closed Railway skeleton (#4).
- Fixture/CI-gated M1 slices (not real product acceptance): #5 ASR control plane,
#6 worker fixture CLI, #7 ingest fixtures, #8 audio control plane, #9
fixture_timelinelocal vertical, #10 offline event normalize, #11 caption PWA with Node-double and Python cross-stack E2E (#44–#54).
The business runtime chain that performs real ASR, live Bilibili acquisition, wire danmaku/SC publication, or provider deployment is not established. Production traffic remains disabled. CUDA remains mock/contract-only. Green CI and closed fixture Issues do not mean hardware, rights, or live gates passed.
See the requirements and evidence index for source authority, evidence categories, and blockers, and the roadmap for the dated direct dependency graph.
# Python fixture_timeline (Issue #9) serving the built #11 shell:
make web-python-e2e
# Or manually:
# PYTHONPATH=packages/protocol/python:services/backend/src \
# uv run python -m livecho_backend.local_vertical --server-only --static-root apps/web/dist
# Node double alone (what make web-check uses):
pnpm --filter @livecho/web demosynthetic_mlx, live ingest, wire publish, and raw archive flags stay closed.
- One operator-selected public and free Bilibili room.
- One cloud ingest, invite-only Apple Silicon/MLX workers, and public live Web UI. Real audio remains disabled for community workers until the named rights and residual-risk gates are approved; synthetic protocol and fixture work may proceed.
- Captions, danmaku, Super Chat, and live-status events are restricted by default and may be retained only after the source-specific policy and Issue 16 deletion gates pass; audio is never persisted.
- CUDA is mock/contract-only during Alpha. Mac native UI and historical crawling are later milestones.
Public availability does not grant redistribution rights. Production ingest remains disabled until the repository owner completes the current platform-policy and rights review described in the change artifacts.
- Alpha modular-monolith ADR
- Threat model and residual-risk register
- Data lifecycle and deletion rules
- Bilibili public-ingest policy
- Independent implementation and license isolation
- Incident disable and recovery runbook
- Railway deployment, rollback, and destruction contract
- Railway secret and managed-reference inventory
These records define constraints and later-Issue verification ownership; they do not claim that a runtime control has already been implemented. The Railway records are repository-only, fail-closed contracts; they do not mean that any Railway environment, resource, provider control, or production deployment exists.
Prerequisites are Python 3.12, uv 0.12.1, Node.js 22, and pnpm 11. The repository requires that exact uv release, so project commands fail before dependency resolution when a different uv version is installed.
make bootstrap
make verifyRead CONTRIBUTING.md and AGENTS.md before proposing a change. Every implementation is linked to a GitHub Issue and versioned intent, spec, plan, and evidence artifacts.
MIT. Dependencies and reference projects retain their own licenses; AGPL source is not copied into this repository.