DEMON example apps

Small frontend examples and creative interfaces for DEMON, the realtime music generation engine.

These apps are plain static files. They do not vendor the DEMON browser SDK; when mounted by a DEMON backend they load the shared SDK from /sdk/demon-client.js.

Apps

App	Path	Route	What it shows
DEMON Tides	apps/tides	/tides	Audio-reactive flow-field visualizer that doubles as an XY control surface.
DEMON Summon	apps/summon	/arp	Hand-tracking control surface for a live DEMON remix session.
DEMON Bloom	apps/bloom	/bloom	Reaction-diffusion organism that maps cursor chemistry to DEMON remix controls.
DEMON Orrery	apps/orrery	/orrery	Celestial-mechanics control surface rendered from the live DEMON manifests.
DEMON Watercolor	apps/watercolor	/watercolor	WebGL2 watercolor painting surface whose simulated pigment drives DEMON knobs.
DEMON Watercolor Codex	apps/watercolor-codex	/watercolor-codex	Compact watercolor control panel for fixture-driven DEMON sessions.
DEMON Face Warp	apps/face-warp	/face-warp	Webcam face-warp interface with kick-reactive DEMON audio controls.
DEMON Tides	apps/tides	/tides	Audio-reactive flow-field visualizer that doubles as an XY control surface.
DEMON Summon	apps/summon	/arp	Hand-tracking control surface for a live DEMON remix session.
DEMON Visage	apps/visage	/visage	Face-tracking control surface: facial expressions drive a live DEMON remix.

Run

From a DEMON checkout:

uv run python -u -m demos.realtime_motion_graph_web.run `
  --demo C:\path\to\demon-example-apps\apps\tides `
  --demo C:\path\to\demon-example-apps\apps\summon `
  --demo C:\path\to\demon-example-apps\apps\bloom `
  --demo C:\path\to\demon-example-apps\apps\orrery `
  --demo C:\path\to\demon-example-apps\apps\watercolor `
  --demo C:\path\to\demon-example-apps\apps\watercolor-codex `
  --demo C:\path\to\demon-example-apps\apps\face-warp

The backend prints direct static demo URLs at startup.

You can also mount one app at a time:

uv run python -u -m demos.realtime_motion_graph_web.run --demo C:\path\to\demon-example-apps\apps\tides
uv run python -u -m demos.realtime_motion_graph_web.run --demo C:\path\to\demon-example-apps\apps\summon
uv run python -u -m demos.realtime_motion_graph_web.run --demo C:\path\to\demon-example-apps\apps\bloom
uv run python -u -m demos.realtime_motion_graph_web.run --demo C:\path\to\demon-example-apps\apps\orrery
uv run python -u -m demos.realtime_motion_graph_web.run --demo C:\path\to\demon-example-apps\apps\watercolor
uv run python -u -m demos.realtime_motion_graph_web.run --demo C:\path\to\demon-example-apps\apps\watercolor-codex
uv run python -u -m demos.realtime_motion_graph_web.run --demo C:\path\to\demon-example-apps\apps\face-warp

Structure

Each app directory contains a demon.demo.json manifest:

{
  "route": "/tides",
  "entry": "index.html"
}

The DEMON backend serves the app as static files at route and serves the shared browser SDK at /sdk/.

Catalog

examples.json mirrors this README in a small structured format so docs, websites, and agents can discover the examples without scraping markdown.