Skip to main content
This is the entry point for working on the open Baryon repo — the web app and the shared visualization engine. It is source-available under the PolyForm Strict License 1.0.0, and contributions are welcome (a one-time CLA is required before your first pull request merges).

​
What lives in the public repo

The public repo is the web app plus the shared engine:
  • apps/web — the browser product shell deployed at app.baryon.live.
  • packages/engine — the engine: audio analysis, AudioFeatureFrame construction, the control schema, render-profile policy, and the raymarch runtime.
  • packages/app-shell — the shared React orchestration around the engine.
  • packages/config — shared build and test config.
  • docs/public — the pages on this site.
The desktop app is a separate commercial product and is not part of this repo. For how these pieces fit together, read the engine architecture.

​
Run it locally

Prerequisites: the Node version pinned in .nvmrc, pnpm, and Chrome or Edge for the WebGPU path. 
git clone https://github.com/BaryonOfficial/Baryon.git
cd Baryon
pnpm install
pnpm dev          # start apps/web
Microphone input and SharedArrayBuffer need a secure context, so use the HTTPS dev server for that work: 
cd apps/web && pnpm dev:https

​
Before you open a pull request

Run the fast verification gate — the same default checks CI runs — and fix any failures before pushing: 
pnpm verify       # lint, typecheck, and unit tests
Branch from develop using a feature/, fix/, or docs/ prefix, and follow Conventional Commits (feat, fix, docs, refactor, test, chore) with a subject line under 72 characters.
New GUI controls must be added through the shared control schema and documented in the control panel reference. The schema is the single source of truth for keys, defaults, and live-vs-debug persistence.

​
Reference