Repositories
Every part of Hero Goggles is in a public repository under save-the-world-org on GitHub. This page lists each one: what it is, where it runs, how to run it and where to read more.
| Repo | What | Live | Latest |
|---|---|---|---|
| hero-goggles | The glasses web app and the live map | hero-goggles.darkshift.cloud | v0.2.1 |
| influence-api | The API: registry, readings, alerts, search, MCP | influence-api.darkshift.cloud | v0.2.1 |
| hero-goggles-ios | The iPhone app: UWB seek, drawn in the lens | On your iPhone, built from source | v0.1.0 |
| beacon-firmware | Tools and firmware for the UWB beacons | On a Qorvo DWM3001CDK | main |
| hero-goggles-docs | These docs and the commercial | hero-goggles-docs.darkshift.cloud | v0.1.1 |
hero-goggles
The Meta Ray-Ban Display web app (a list, a map and Find, driven by the Neural Band) and, at /live/, the live map of the Salt Palace: the beacons, Skyhook Radar's alerts, the registry, influencer pages, Find by voice, WebMCP, and the integrations with each sponsor's logo.
| Source | github.com/save-the-world-org/hero-goggles |
|---|---|
| Runs at | hero-goggles.darkshift.cloud and /live/, an Infrared Product on the hosted plane |
| Built with | Vite, React on preact/compat, MapLibre; built by Paketo buildpacks and served by nginx |
| Run it | npm install, npm run dev (http://localhost:5173), npm run build |
| Check | npm run build; Gitar by Sonar reviews each pull request against .gitar/rules/instrumentation.md |
| Read more | Quick start, Skyhook Radar, Gitar by Sonar |
influence-api
The API behind Hero Goggles: the beacon and influencer registry, live readings from the phone, who each seeker is looking for, distance alerts, a live event stream for the map, search over KubeCon's sessions and speakers, and the same actions as MCP tools (find_influencer, where_is, list_influencers, search).
| Source | github.com/save-the-world-org/influence-api |
|---|---|
| Runs at | influence-api.darkshift.cloud; MCP at https://influence-api.darkshift.cloud/mcp |
| Built with | One file, server.js, on Node 22; OpenTelemetry to Dash0; Elasticsearch when ES_URL is set |
| Run it | npm start (http://localhost:8080); claude mcp add --transport http influence https://influence-api.darkshift.cloud/mcp |
| Check | npm test: the server as real processes, against a fake Elasticsearch and with none |
| Read more | Architecture, Elasticsearch, Dash0, MCP |
hero-goggles-ios
The iPhone app on Meta's Wearables Device Access Toolkit: it draws on the Ray-Ban Display glasses, takes Neural Band presses, and seeks a UWB beacon (“Hero Finder”), with the distance and the way on the phone, in the lens and aloud. Each reading goes to influence-api.
| Source | github.com/save-the-world-org/hero-goggles-ios |
|---|---|
| Runs at | Your own iPhone, signed with your own Apple Developer team; or a simulator with Meta's simulated glasses |
| Built with | Swift, SwiftUI, Nearby Interaction, Meta's Wearables Device Access Toolkit 1.0.1; Xcode 27.1 or later and XcodeGen |
| Run it | make sim (simulator), make device (your iPhone) |
| Check | make verify |
| Read more | Quick start, Architecture |
beacon-firmware
Firmware and tools for the UWB beacons, Qorvo DWM3001CDK boards: uwbprobe, a test firmware of our own with no SDK; our patches to Qorvo's Nearby Interaction firmware and its build; scripts to identify, back up and flash a board; serial and Bluetooth tools. Qorvo's SDK is never in the repo.
| Source | github.com/save-the-world-org/beacon-firmware |
|---|---|
| Runs at | A DWM3001CDK board, carried by the person to be found |
| Built with | C (Apple's clang), probe-rs, Python's standard library, shell |
| Run it | brew bundle --file=Brewfile, scripts/identify, scripts/backup, make flash-uwbprobe |
| Check | make verify |
| Read more | Architecture |
hero-goggles-docs
These pages: the overview with the commercial, the quick start, the architecture, a page per sponsor integration, how Infrared builds and hosts it all, and the thanks.
| Source | github.com/save-the-world-org/hero-goggles-docs |
|---|---|
| Runs at | hero-goggles-docs.darkshift.cloud, an Infrared Product on the hosted plane |
| Built with | Plain HTML and one stylesheet, no build step |
| Run it | Any static server, e.g. python3 -m http.server |
| Check | None beyond the deploy's smoke check |
| Read more | Overview, Built on Infrared |