Boss Loops OSS

Boss Loops OSS is the open-source, self-hosted distribution of Boss Loops. It runs the same governed operating-loop model as Boss Loops Cloud — you operate the runtime yourself.

Boss Loops OSS is powered by the Loop Engine runtime and packages (@loop-engine/*). Loop Engine is the technology; the runtime architecture and package APIs are documented under Runtime. Canonical OSS source: loopengine/loop-engine.

Product vs technology (BL-DOC-07). This page is Boss Loops OSS product documentation (what the open-source distribution is, how to run it). Loop Engine technology documentation — runtime architecture, state-machine model, actor framework, package APIs — lives under Runtime.

5-minute local demo (no credentials)

Prove the canonical Spreadsheet Approval Loop locally — no Slack OAuth, no Google OAuth, no cloud dependency:

1# from a bd-forge-main / loop-engine checkout
2pnpm boss-loops:demo --dry-run

You'll see the loop walk staged change → approval → applied → audit trail over seeded evidence, validated against the real loop template. To see the same run in Studio:

1make self-host-up && make self-host-seed
2open http://localhost:3020/runs/self-host-demo-run-1/dual-surface

OSS proves the loop. Cloud runs the workflow. Live Slack + Google execution is Cloud-first — see Boss Loops Cloud. OSS does not run live Slack + Google.

In this section

• Installation and self-hosting
• Deployment
• Integrations
• Loop Engine packages (@loop-engine/*)

Open-source product content is reconciled into these pages in a later pass (sources: loopengine.io, docs-site, package READMEs). Source content is preserved until then (CC-DOC-01).