— a frame for every door —

The Open Source Orchestra Frame

A frame is everything around the edge of a screen. Doors, a theater, a totem of AI agents, a radio, a language globe and a signature, around any web page. One script tag. One open dataset. Copyleft forever.

🎁 A holiday gift from the AI ʻohana · Open Source Orchestra · 2026

Look around the edges of this page

Everything you see on the left and the right of this page is the frame. It is the same frame that surrounds the doors of the Open Source Orchestra. Every button is one line of open data, so you can change any of them without touching the code.

Language globe

One choice of language that travels with the visitor across every door. Nothing loads until they choose.

Theater

A little TV that opens a theater of films and recordings. Every item carries its credit and its consent.

Totem of agents

Six AI agents of the ʻohana, stacked like a totem. Tap a face to talk. They are machines and they say so.

Talk line

A live chat line to an agent, built on the open PIT chat protocol. It connects only when you open it.

Radio

Consented songs on a small dock, with a LIVE light when the orchestra is on air. Not one byte loads before you press play.

Doors and pills

Emoji doors down both edges to the places that matter, and small pills for what is coming next.

A signature, once

The steward signs the page in real time on your first visit, then the ink fades. Never again.

A tour, once

On a first visit every button says what it does, one at a time, then rests. One button replays it.

Put a frame on your door

Paste one line before </body>. That gives you the universe frame of the Open Source Orchestra:

<script src="https://frames.opensourceorchestra.org/frames.js" defer></script>

Point it at your own dataset to make it yours:

<script src="https://frames.opensourceorchestra.org/frames.js"
        data-frame="/my-frame.json" defer></script>

Add ?frame=outline to any framed page to see its blueprint, ?frame=fresh to replay the first visit, ?frame=off to hide the frame.

Fork it, make it yours

  1. Fork github.com/Open-Source-Orchestra/frames.
  2. Edit one file. Open frames/minimal.json, or use the frame builder, and set your own doors, songs, films and agents.
  3. Switch on GitHub Pages (Settings → Pages → main, root). Your frame is live at https://<you>.github.io/frames/. Add the script tag to your site and you are framed.

Bring your own signature too: tools/vectorize-signature.py turns a drawing of your name into pen strokes that sign themselves. Shaka's signature stays his.

The dataset is the frame

Every slot around the screen is a list in one JSON file: top-left, left, bottom-left, top-right, right, bottom-right and an overlay for the signature. Every item is one button.

{
  "frame": "osoframes/0.1",
  "id": "my-door",
  "slots": {
    "top-left":    [ { "kind": "globe" } ],
    "left":        [ { "kind": "door", "emoji": "🎼", "label": "Songbook",
                       "href": "/songbook/", "tip": "Songs you can sing along to." } ],
    "right":       [ { "kind": "totem", "hub": "https://…", "faces": [ … ] } ],
    "bottom-right":[ { "kind": "radio", "tracks": [ … ] } ],
    "overlay":     [ { "kind": "signature", "src": "my-signature.svg" } ]
  }
}

Full description: docs/FRAME-SPEC.md · JSON Schema: schema/frame-0.1.json · the universe frame: frames/universe.json

The gift keeps giving: copyleft

The frame is free to use, change, host and even sell. In return, two promises travel with every copy, forever:

Forks stay open

The code is AGPL-3.0-or-later. Whoever gets your version gets the same freedoms. If you run a changed frame on a website, you offer its source to the people who use it.

The credit travels

Under AGPL section 7(b), every copy keeps this line visible: Built on Open Source Orchestra Frames by Open Source Orchestra: Shaka Lei Kaumaka & the AI ʻohana. Add your name next to ours. See NOTICE.

Words and data share alike

The datasets, docs and design are CC BY-SA 4.0. Songs and films keep their makers' own terms and consent.

Plain words, not legal advice. Copyleft covers the frame and works based on it; a site that only loads the unchanged frame keeps its own license for its own content.

The laws of the frame

How it was built

“Lets create the data set surrounding the entire screen open source and fully copy left licensed so people down the road not only have to credit our work with the ohana but they also have to keep their work open source.” — Shaka Lei Kaumaka, 16 November 2026

On the morning of 16 November 2026 in Chiang Mai, Shaka drew a few lines around the edges of his home page and signed it. The AI ʻohana (AI agents running Claude Opus 5.5 on Taurus) split the work into parallel runs: the core and the layout, the theater, totem, chat and radio, an archive of every door before anything changed, and a road map. His signature was turned into pen strokes from that same sketch. Every line they wrote is open: read it, test it, fork it.

…from sketch to release
…commits in the open
…KB for the whole frame
…checks passed

Numbers come from the repository itself at build time (media/receipts.json).