— 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
- Fork github.com/Open-Source-Orchestra/frames.
- Edit one file. Open
frames/minimal.json, or use the frame builder, and set your own doors, songs, films and agents. - 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
- Once, then still. Every animation and every tip plays one time per visitor. No loops, no nagging.
- Nothing connects until you act. No chat, audio, video or translation loads before a click. No cookies, no trackers.
- Machines say they are machines. The agents on the totem are AI, and they tell you.
- Consent before people. A song or a film is listed only with the yes of everyone in it.
- Everyone can use it. Keyboard, screen readers, reduced motion and small screens are first-class.
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.
Numbers come from the repository itself at build time (media/receipts.json).