Working notes / architecture

Read the room.

A concise map of the product, the local runtime, the provider boundary, and the static public plane.

Local data plane. Static public plane. ● Keep the line clear. ●
Architecture / two planes

Information here. Rooms there.

Public project plane

This site publishes project, documentation, download-status, and contribution guidance. It has no account, model proxy, credential entry, transcript ingestion, room state, analytics, or cookies.

Local data plane

The local runtime owns room state, provider configuration, scheduling, memory, provider calls, and local credential references. Green Room is usable without a project account or project-operated service.

Provider boundary

Users connect their own local or cloud LLM through the local application. A local provider can keep inference on the user’s machine. If a user selects a cloud provider, the provider receives the bounded context needed for inference; local setup must disclose that boundary.

House rules / product behavior

What stays true.

NOTE 01

Ensemble first

The room matters more than any single chatbot. Personas notice one another, and difference makes the scene move.

NOTE 02

Bounded direction

The deterministic director chooses zero or one eligible speaker and enforces cooldowns, budgets, cancellation, pacing, and loop prevention.

NOTE 03

Inspectable continuity

Memory is intended to remain bounded, attributable, inspectable, correctable, exportable, and deletable.

Current stage / no release fiction

Private alpha to community release.

  • Verified baselineA standalone Node 24, Fastify, and SQLite private/local alpha with twelve researched historical character packs installed.
  • Next provider workRevisioned connection and model profiles behind adapters, with local secret references and bounded tests.
  • Character systemOne portable declarative pack format shared by the Character Wizard, strict validator, local installer, and reviewed community library.
  • Packaging directionDocker Compose and a local web bundle before evaluating a desktop wrapper.
  • Public releaseForthcoming; artifacts and checksums must be verified before any download is posted.

Need the full working documents?

The repository contains the product brief, roadmap, architecture, accepted ADRs, contribution policy, security policy, and content boundaries.

Open the GitHub repository