[eliteprox]

Summary

• Add a Livepeer live-runner path that registers ComfyStream as app comfystream (capacity 1) against a go-livepeer orchestrator with -useLiveRunners, driving comfystream.Pipeline in-process (no BYOC/pytrickle subprocess).
• Expose an agent-shaped HTTP surface for video-in→text-out and live trickle sessions: POST /analyze, POST /start_stream, POST /update_stream, GET /text, GET /healthz.
• Ship Docker packaging (Dockerfile.live-runner, docker-compose.live-runner.yml, --live-runner entrypoint), optional .[live-runner] deps, a smoke client, and a stub analyze workflow.
• Also includes supporting workspace/ComfyUI cwd cleanup (--workspace / --cwd), constraint/override-based node installs, and CI workflow fork-restriction removals needed to operate from this branch.

Motivation

ComfyPeer / live-runner work wants ComfyStream sellable as a session wall-clock / latency runner on an existing orchestrator—same registration + trickle path as the transcode live-runner—rather than a batch $/image race or legacy BYOC.

What's included

Live-runner

Piece	Role
server/live_runner.py	Register runner, create trickle channels, run Pipeline sessions
server/live_runner_client.py	Smoke client: reserve → analyze/stream → update → stop
docker/Dockerfile.live-runner	Overlay image on livepeer/comfystream + livepeer-gateway
docker-compose.live-runner.yml	Host-network attach to an already-running orchestrator
docker/entrypoint.sh	--live-runner → python server/live_runner.py …
workflows/comfystream/analyze-stub-api.json	Minimal video→text stub for bring-up
pyproject.toml	Optional live-runner extra

Supporting (earlier on branch)

• Normalize ComfyUI workspace handling (--workspace, config passthrough, client init)
• Script/dependency hygiene (constraints.txt, overrides.txt, setup_nodes / build_trt)
• Remove GitHub Actions repo-owner guards so fork CI can run

Legacy BYOC (server/byoc.py) is unchanged.

Quick test

# Attach to an orchestrator that already has -useLiveRunners
docker compose -f docker-compose.live-runner.yml up -d --build
curl -sk "$LIVEPEER_ORCH_URL/discovery" | jq '.[].runners[].app'

pip install '.[live-runner]'
python server/live_runner_client.py sample.mp4 \
  --workflow workflows/comfystream/analyze-stub-api.json \
  --discovery "$LIVEPEER_ORCH_URL/discovery"

Test plan

• Compose build succeeds; runner appears in orchestrator discovery as comfystream
• Smoke client analyze against stub workflow returns text
• start_stream + frame publish produces trickle video (and optional text)
• update_stream applies mid-session workflow/prompt change
• Orchestrator session release cleans up active session (capacity returns to 1)
• /healthz healthy while idle and during a session
• Confirm secrets/host defaults in docker-compose.live-runner.yml are overridden via env (no committed orch secrets in final merge)
• Existing WebRTC / BYOC paths still work; workspace --config still preserves --workspace

Notes / follow-ups

• Depends on livepeer-gateway branch ja/live-runner until that lands on a tagged release.
• Compose file currently carries host-specific GPU UUID / orch URL defaults—should be env-only before merge.
• Protobuf: live-runner image installs protobuf>=6.31.1 for gateway pb2; call out any ComfyUI pin tension in review.

[codecov]

Codecov Report

❌ Patch coverage is 80.26667% with 74 lines in your changes missing coverage. Please review.
✅ Project coverage is 82.79070%. Comparing base (06b2a27) to head (5443744).
⚠️ Report is 10 commits behind head on main.

Files with missing lines	Patch %	Lines
server/live_runner_batch_client.py	27.47253%	66 Missing ⚠️
test/conftest.py	50.00000%	7 Missing ⚠️
test/test_batch_http.py	99.30556%	1 Missing ⚠️

Additional details and impacted files

@@                  Coverage Diff                  @@
##                 main        #594          +/-   ##
=====================================================
- Coverage   100.00000%   82.79070%   -17.20930%     
=====================================================
  Files               1           6           +5     
  Lines              55         430         +375     
=====================================================
+ Hits               55         356         +301     
- Misses              0          74          +74     

Files with missing lines	Coverage Δ
test/test_fal_catalog.py	100.00000% <100.00000%> (ø)
test/test_job_pool.py	100.00000% <100.00000%> (ø)
test/test_batch_http.py	99.30556% <99.30556%> (ø)
test/conftest.py	50.00000% <50.00000%> (ø)
server/live_runner_batch_client.py	27.47253% <27.47253%> (ø)

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4e9dace...5443744. Read the comment docs.

Files with missing lines	Coverage Δ
test/test_fal_catalog.py	100.00000% <100.00000%> (ø)
test/test_job_pool.py	100.00000% <100.00000%> (ø)
test/test_batch_http.py	99.30556% <99.30556%> (ø)
test/conftest.py	50.00000% <50.00000%> (ø)
server/live_runner_batch_client.py	27.47253% <27.47253%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.