The situation console you run yourself.

Every public aircraft, ship, satellite and hazard feed on one globe, recorded to your own disk.

No account. No API key. Nothing deleted after 7 days.

docker compose up Watch the tour · 1:51

Why it exists

Free trackers keep cutting their history. Velocity records yours.

Flightradar24 gates replay at seven days. MarineTraffic cut its free window to 24 hours. ADS-B Exchange killed its free API. Velocity pulls the same public feeds onto one globe and writes every position to a database on your disk, so the thing you saw last month is still there, scrubbable, and yours.

	History you can replay	Self-hosted	Account or API key	Who owns the archive
Velocity	Unlimited, bounded by your disk	Yes	None	You
Flightradar24	7 days on the free tier	No	Account	Them
MarineTraffic	24 hours free, down from 72	No	Account	Them
ADS-B Exchange	Free API tier discontinued	No	Paid API	Them

On the dev box the archive holds 45,414,961 positions in 9.25 GB of SQLite, recorded since 9 August 2026, and plays back at 1x to 3600x over windows from one hour to seven days.

Retention is honest: the default compose caps the rolling archive at 2 GB. Set ARCHIVE_MODE=1 and it grows to whatever disk you give it, about 3 GB per hour with every feed on.

A police helicopter selected over Frankfurt: its dossier on the right, its recorded track drawn under the glyph — A police helicopter selected over Frankfurt on the dev box, July 2026. The dossier opens on the right and the line under the glyph is its recorded track, drawn from the archive, not the feed.

Ten minutes in

What an analyst does first, recorded on the running console.

No demo site exists because the feeder terms do not allow public redistribution. These are recordings of the product, not renders.

01 · Click anything

Get the dossier and the whole track.

Every aircraft, vessel and satellite is an object with a registry, provenance per field, and the position history you have recorded for it. Click it and the track draws from the archive, not from the feed.

02 · Rewind

Scrub any layer to any past minute.

Pick a window from one hour to seven days, click the density strip, and the globe rewinds. The header swaps from Live to Replay and one button puts you back. Playback runs from 1x to 3600x.

03 · Ask an agent

Give your model real eyes.

85 MCP tools sit over the same live store: situation, density, jamming, vessel queries, dossiers, replay. Point Claude Code or any MCP client at your own instance. The answer above is a real call from this box.

Install

Install on your own hardware.

Clone the repo and run docker compose up. The API, the web app and nginx come up together on localhost:8080, feeds fill on first load, and the archive starts recording to a Docker volume from the first minute.

$ git clone https://github.com/AndrewCTF/velocity.git $ cd velocity $ cp .env.example .env # optional, empty works $ docker compose up # api + web + nginx on :8080

Prerequisite: Docker 24 or newer with the compose plugin. Without Docker: Node 20, pnpm 9, Python, and make install. The globe leans on your GPU, so on a laptop with switchable graphics put the browser on the discrete card before judging the frame rate.

Quick start on GitHub Releases

2,593 backend tests pass on this tree, run 2026-09-13.

What it needs

A laptop with integrated graphics and 8 GB of RAM runs the default lite profile: the 2D map with about 9,000 aircraft and 32,000 vessels, and a backend that fits in 1.5 GB.
A discrete GPU with 8 GB of VRAM and 16 GB of RAM runs every feed, and the 3D satellite view at city scale.
An RTX 4070 or better with 32 GB of RAM runs everything, including the browser sidecars, 3D terrain and buildings, at up to 4K.

Measured with the benchmark in the repo, not estimated. The 3D satellite view eats VRAM; the 2D map is the default for a reason.

The Velocity console on localhost:8080 with the layer rail open beside the globe — The console on localhost:8080, layer rail open. Recorded on the dev box.