logo

Isaac Companion

An offline encyclopedia for The Binding of Isaac — 900+ items, trinkets and bosses in your pocket, with on-device screenshot recognition.

iOS 18+ · SwiftUI · Core ML · Free, no ads

TestFlight GitHub

Item gridItem detailSettingsItem quizI'm Feeling Lucky dice

Why I Built It

Every Isaac run ends the same way: pause, pull out my phone, google the item I just picked up, scroll past a wall of text to find the one line I needed — then come back and forget what I was doing. The wiki is great, but it's built for browsers, not for the 30 seconds between item pickups.

What It Does

How We Built It

The data pipeline scrapes the community Rebirth wiki (wiki.gg) and cleans years of MediaWiki template markup into structured JSON — preserving bullet lists, phase sections and per-DLC values. A Core ML model trained on 700+ item icons powers the screenshot recognition, running entirely on-device. The app itself is native SwiftUI with light/dark mode, multiple app icons and full offline support.

Challenges

Turning messy MediaWiki templates into structured JSON without destroying bullet and phase formatting took several iterations. The item classifier's second retrain regressed on real-world screenshots — I shipped v1 and kept the backup instead of chasing a worse model.

What's Next

Published: 2026-09-10