Videos

Twenty-three short explainers across six series — about twenty-five minutes of cinematic context for the architecture. Voice: ElevenLabs George (voice-locked across the OpenIE family). Visuals: Replicate Kling and BFL Flux.

All videos are CC-BY-SA 4.0. Source production plan, narration scripts, and rendering pipeline live in shoal-video/.


S1 — Hero

A 90-second introduction. The whole project in eight beats: pollution everywhere, no one watching, a fish that swims it, the gut that eats it, the family of cartridges, the dock, the data, the brand.


S2 — Why

Three top-of-funnel explainers, ~85 seconds each. The morphological case, the philosophical case, the historical case.

Why fish

The morphology nobody picked is the one the problem was waiting for.

Why open

What looks like generosity is actually leverage.

Why now

The recipe was waiting on the cook.


S3 — The fish

Subsystem deep dives, ~60 seconds each. Technical, matter-of-fact.

1. The chassis

2. The gut

3. Sensors

4. Swimming

5. Cognition

6. Dock interaction

7. End of life


S4 — The cartridge family

Six shorts, ~50 seconds each. Each cartridge is a solution to a real-world pollution problem.

gut-hc-v1 — Hydrocarbons

gut-org-v1 — Organic load

gut-n-v1 — Nitrogen

gut-metal-v1 — Heavy metals

gut-plastic-v1 — Microplastics

gut-pfas-v1 — PFAS


S5 — The dock

Three shorts, ~60 seconds each.

Dock-A — Autonomous benthic

Dock-B — Shore-tethered

The biology reservoir


S6 — Deployment

Three shorts, ~85 seconds each. How the kit gets used in the world.

Build a fish

Deploy a shoal

The data product


shoal is open source. Hardware: CERN-OHL-S 2.0. Software: Apache 2.0. Docs and data: CC-BY-SA 4.0. Datasets: CC0 1.0.

This site uses Just the Docs, a documentation theme for Jekyll.