Skip to content
rmnglPublic

About

Loop turns Buzz into a workspace you run on your machine—relay, desktop, and agents in one flow, without Block hosting.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5,841 Commits

Folders and files

Repository files navigation

Loop

Loop runs a local workspace where people and agents share channels, threads, and workflows on your relay—with a desktop client and tooling to start everything from one place.

The relay and protocol come from Buzz (Apache 2.0). The desktop UI is based on buzz-app (Apache 2.0). Both live in this repository under third_party/. Loop adds supervision, install paths, and product packaging—not a separate chat protocol.

Platforms

macOS, Linux, and Windows (Git Bash). The default stack uses Postgres, Redis, and MinIO on the host—not Docker. Container-based setup remains optional.

See docs/native-install.md.

Prerequisites

  • Git
  • Native stack (default): Postgres 17, Redis 7, MinIO (Loop can start MinIO if the minio binary is on PATH)
  • Docker (optional): only when LOOP_STACK=docker
  • Disk for data and toolchains (Hermit inside third_party/buzz pulls Rust/Node on first make init)

Quick start

git clone <this-repo> loop && cd loop
make serve          # first-time init + relay at ws://127.0.0.1:3000

Background supervisor: make start / ./bin/loop start. Desktop: make desktop-dev (applies Loop client patch, starts relay if needed).

Configuration: .env.example. Smoke checks: make verify. Full native stack: make integration-native.

Desktop

make start
make desktop-dev

Relay URL: ws://127.0.0.1:3000. Details: docs/desktop-build.md, docs/local-experience.md.

Agents

CLI agents use the same relay (buzz-cli, BUZZ_PRIVATE_KEY). See docs/agent-quickstart.md.

Documentation

Doc Topic
docs/local-experience.md One entrypoint UX
docs/native-install.md Host dependencies
docs/buzz-upstream.md Relay engine in third_party/buzz
docs/buzz-app-upstream.md Client in third_party/buzz-app
third_party/UPSTREAM-PINS.md Upstream commits and sync
docs/desktop-build.md Build and run the client
docs/desktop-supervisor.md loop start / stop contract
docs/managed-roadmap.md Hosted Loop (planned)

Configuration

Variable Default Meaning
LOOP_STACK native native or docker
LOOP_BUZZ_SRC third_party/buzz Relay tree
LOOP_BUZZ_APP_SRC third_party/buzz-app Desktop tree
LOOP_RELAY_WS_URL ws://127.0.0.1:3000 Client relay URL

Buzz runtime settings: third_party/buzz/.env (created on make init).

License

This repository is Apache 2.0 (LICENSE). Buzz and buzz-app retain their upstream licenses and notices.

About

Loop turns Buzz into a workspace you run on your machine—relay, desktop, and agents in one flow, without Block hosting.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages