Skip to content

wranngle/ORBFORGE

Repository files navigation

ORBFORGE

burning rings · glassy globes · plasma cores · 3D wireframe sculptures · live WebGL console · 39 parameters · seeded archetypes · editable layers · 12 built-in presets · WebP · GIF · PNG · JPG · JSON export

AI agent avatar synthesizer: shape an orb, download the loop

Features | Presets | Grab an orb | Getting started | Shortcuts

Free, runs entirely in your browser, no login or account required.

❤️ Sponsor this project ❤️

CI Release License Last commit Contributors

GitHub stars Follow on GitHub


The ORBFORGE console in motion: rolling new orbs and sweeping parameters as the live WebGL preview reacts

ORBFORGE is a WebGL console that renders a living animated orb — a burning ring, a glassy globe, a plasma core, a 3D wireframe sculpture — and exports it as a transparent animated WebP or GIF, a single PNG or JPG frame, or a JSON recipe, seed and full config baked into every file. Dial the 39 parameters by hand, roll a seeded archetype, stack editable layers, or start from one of 12 built-in presets; loop durations solve to whole cycle counts, so every animated export repeats without a visible seam. It is a static page with no build step, no server, and no account.

Features

  • Live WebGL preview: seven surface texture styles (smoke, ridged filaments, plasma cells, banded rings, woven threads, stipple dots, wire lattice) that wrap a true 3D sphere via longitude/latitude — spinning dot, wire, and ring matrices — plus torus and sphere lighting, a volumetric core with radial plasma filaments, orbiting tracers, adjustable playback speed, glow, chromatic aberration, and a video-player transport (play, pause, scrub, speed, fullscreen) over the render.
  • 39 parameters in seven groups, each with a slider, hold-to-repeat steppers, and a typeable value field. Hovering a parameter draws a pink marching-ants marquee around the exact region of the render it controls, tracked live by the shader.
  • Seeded, archetype-weighted randomize: each roll picks a coherent archetype (burning ring, plasma ball, glassy sphere, wire mesh, lit sculpture, thick aura) with correlated parameter ranges, so distinct species emerge instead of uniform noise. Every roll stamps a human-readable seed (plasma-4f2a) that deterministically rebuilds the same orb — and Roll rerolls whichever layer you're editing.
  • Editable layers: stack up to 3 presets additively above the base orb for composite looks; each layer is a tab you can select to edit its own parameters, hide, roll, or remove — and every visible layer rides along in the animation and the JSON.
  • Transparent by default: true alpha out of the box, or bake in a solid or gradient backdrop with hex-precise colors.
  • Five export formats: animated WebP (browser-native, transparent) and GIF (built-in median-cut, Floyd-Steinberg, LZW encoder) for loops; PNG and JPG for a single frame you pick with a scrubber and preview in-dialog; and JSON for the re-importable recipe. A target-file-size auto-tuner picks resolution, fps, and quality to fit a byte cap; the animated size estimate updates live.
  • 12 built-in presets plus user presets saved to localStorage, with undoable delete.
  • Event log: every action emits an ECS-shaped JSONL record you can copy or download as .jsonl.

Preset gallery

All twelve built-in presets rendered by the engine, from Ember comet to Obsidian sculpt

Grab an orb

The v1.1.0 capability pack ships six new orbs that show off the engine's newer tricks — true 3D longitude/latitude spheres, spinning dot and wire matrices, and volumetric cores. Drop one straight into a chat avatar, an agent UI, or a README; paste its seed into the in-app Import box to keep editing it.

Orb Preview Seed Frames
Lattice bloom Lattice bloom orb plasma-9f2a 80
Sea urchin Sea urchin orb glass-4c71 79
Amethyst globe Amethyst globe orb sculpt-a13f 38
Crimson matrix Crimson matrix orb quasar-3e9b 73
Rose datasphere Rose datasphere orb flux-d8a1 94
Dusk halo Dusk halo orb nova-51cc 126

The original 12 built-in presets ship pre-exported on v1.0.0.

Getting started

  1. Clone and serve

    git clone https://github.com/wranngle/ORBFORGE && cd ORBFORGE
    python3 -m http.server 8080
  2. Open http://localhost:8080, pick a preset or hit ROLL, then click DOWNLOAD (animated WebP/GIF, a single PNG/JPG frame, or the JSON recipe).

Or skip the clone: the same page is live at orbforge.wranngle.com.

WebGL is required for the preview; WebP export uses browser-native WebP encoding (Chrome, Edge, or a recent Firefox), and Safari falls back to the built-in GIF encoder.

JSON I/O and shortcuts

Control Action
⌘/Ctrl + Z Undo
⌘/Ctrl + Shift + Z, or ⌘/Ctrl + Y Redo
Space Play or pause
F Fullscreen
Download → JSON Copy or download the full config; re-import it to keep editing
Import box Paste a config JSON or a bare seed (plasma-4f2a) — or drop a .json, .webp, or .gif — to rebuild the exact orb

Where an orb goes

A finished orb is a small transparent looping image, so it goes anywhere one does.

Agent avatars
a face for your AI agent's idle and thinking states
Chat UIs
profile pictures that move in Slack, Discord, Teams
Loading states
a looping indicator in place of a spinner
Stream overlays
OBS and Twitch talking or brb badges
README headers
the glowing-glyph treatment this page uses
...anywhere an image goes
the export is a plain file

Named surfaces are usage examples, not integrations.

Star history

GitHub stars

View the interactive star history, drawn live even while star-history's image API is down.

License

MIT © Wranngle Systems LLC. See LICENSE.

About

AI agent avatar synthesizer — forge a living WebGL orb (39 params, seeded archetypes) and export a transparent animated WebP, GIF, PNG, JPG, or JSON recipe.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages