Embed SDK

aios-geo.js

Drop a single <script> tag into any page to embed live AIOS visualisations — Merkaba handshake animations or live .geo programme renderers.

Live Demos

Merkaba Handshake · 528 Hz Default embed. Two counter-rotating tetrahedra — PHI-driven coherence animation.
Merkaba · 396 Hz Lower frequency (entity resonance band). Slower pulse rhythm.
Merkaba · 963 Hz High-frequency (narrative/projection band). Rapid coherence pulse.

Quick Start

Load the SDK and call AIOS.init() on any container element: 

<!-- 1. Container -->
<div id="aios-vis" style="width:400px;height:300px"></div>

<!-- 2. Load SDK -->
<script src="https://realaios.com/aios-geo.js"></script>

<!-- 3. Initialise -->
<script>
  AIOS.init({ target: '#aios-vis' });
</script>

Auto-Init with Data Attributes

Add data-aios to any element — the SDK initialises it automatically after the DOM loads: 

<div data-aios
     data-aios-mode="merkaba"
     data-aios-freq="528"
     data-aios-label="My Label"
     style="width:400px;height:300px">
</div>

<script src="https://realaios.com/aios-geo.js"></script>

Render a .geo Programme

Fetch a live programme from the AIOS catalogue by ID and render it:

AIOS.init({
  target:  '#aios-vis',
  mode:    'geo',
  geoId:   'matrix-awakening',   // any ID from /api/geo/catalogue
});

Or pass an inline .geo object directly:

AIOS.init({
  target: '#aios-vis',
  mode:   'geo',
  geo: {
    id:     'my-prog',
    title:  'My Programme',
    scenes: [{ frequency: 528, nodes: 8 }],
  },
});

Options Reference

Option Type Default Description
target string | Element — CSS selector or DOM element to render into. Required.
mode string 'merkaba' 'merkaba' — Merkaba handshake animation. 'geo' — .geo programme renderer.
geoId string — Programme ID to fetch from /api/geo/:id. Used when mode='geo'.
geo object — Inline .geo programme object (skip the API fetch).
frequency number 528 Hz frequency for Merkaba pulse rhythm (396, 528, 639, 741, 852, 963…).
label string '' Watermark label shown inside the canvas.
autoplay boolean true Start animation immediately on init.
width number container width Canvas pixel width.
height number container height Canvas pixel height.

AIOS API

Method Description
AIOS.init(options) Create a single instance in a target element. Returns the instance handle.
AIOS.embed(selector, options) Initialise AIOS in all elements matching selector. Returns array of instances.
AIOS.stop() Pause all running instances.
AIOS.play() Resume all paused instances.

SDK URL

https://realaios.com/aios-geo.js

The script is served with Access-Control-Allow-Origin: * and Cache-Control: max-age=3600. It has zero external dependencies and works in all modern browsers.