OSAGI AI Orbs

Status orbs for AI assistants

Six WebGL components for React. Set one prop, state, and the orb changes colour, size and tempo to match.

listening
  1. Person“Rename the photos in this folder by date.”
  2. AppNo one has asked for anything.
Assistant state

The six orbs

They take the same ten states and the same props. What differs is how each one is drawn and where it fits.

Liquid glass

On this paper
On its ink

Three sheets of liquid fold over each other inside a ball of smoked glass, lit from below. A pool of light lies on the floor under it.

The one to start with. Its body is almost opaque, so it keeps its shape on a light ground and on a dark one. Put it where the assistant lives: beside the composer, in a header, on a voice screen.

<LiquidGlassOrb />Anatomy and code

Particle nebula

Four thousand points run along 48 spiral lines from pole to pole. A crust of points marks the rim, and wisps peel away from it.

It wants room and a dark ground. Give it a hero, an empty state or a full voice screen. On a small canvas it drops points so the cloud does not clot, and the detail goes with them.

<ParticleNebulaOrb />Anatomy and code

Two slow layers of noise bend a third, and the palette runs through the folds like ink in water. A halo turns around the disc.

The lightest shader in the pack and the shortest file. It has no fine detail to lose, so it is the one for small places: a list row, a tab, a button. It reads best on a dark ground.

<PlasmaAuroraOrb />Anatomy and code

In a list row at 28 pixels, in a tab and in a button at 20.

Wireframe globe

  1. Three satellites on thin orbits
  2. A node at every crossing
  3. This side crumbles as turbulence rises

Twenty meridians and nine parallels turn on a tilted axis, with three satellites on thin orbits around them. On one side the grid crumbles into drifting dots.

For agents that spend their time in tools. The lines are one pixel wide, so give it at least 120 pixels and a dark ground.

<WireframeGlobeOrb />Anatomy and code

Voice ring

A ring of 120 bars around a dark core, with two thin waves outside it. The orb carries its own dark disc, so it looks the same on a light page and on a dark one.

Voice screens and calls. It does not listen to a microphone: the bars follow the state. The centre is empty on purpose, for a label, a timer or a mute button.

<VoiceRingOrb />Anatomy and code

Ferrofluid

A glossy black ball with fourteen soft spikes that rise and melt, lit from behind in two colours of the palette. The white glints stay white in any palette.

The heaviest shader here, drawn at a pixel ratio of 1.5 at most. Use one, give it room, and keep it out of long lists.

<FerrofluidOrb />Anatomy and code

One turn, ten states

A state is five numbers and three colours in core.tsx. Change them there and all six orbs follow. The turn on this site is scripted; yours comes from your agent's own events.

Assistant state
Energy
0.50
Pulse
1.00
Scale
0.90
Speed
0.80
Turbulence
0.20

02 listening

Person“Rename the photos in this folder by date.”

What each state means and when to set it

Copy two files

An orb is core.tsx and one file of its own. They import React and nothing else, so there is no package to install and nothing to keep up to date.

$5, once. The licence covers one product and one team, and you may sell what you build. You get the six orbs and this site as source, with every update published. Read the licence

components/assistant-status.tsx
import {
  LiquidGlassOrb,
} from "./orbs/liquid-glass-orb";

export function AssistantStatus({
  status,
}) {
  return (
    <LiquidGlassOrb
      announce
      state={status}
    />
  );
}
Use it