[ Open source · On-device vision model ]
bitcoin-vision is a small set of vision models and a Rust library. It turns a photo of a BIP39 recovery phrase or a Penlock share into words you can check, with a confidence score for every one.
01 · Playground
Press Run to replay the pipeline on a sample page, step by step. Or use your own practice photo: the real models run right here in your browser, and the photo stays on your device unless you choose to share it.
INPUT · sample-recovery-page.jpg
Practice words only. Never photograph a real backup on a connected device.
Press Run to find, read, match and check the 12 words.
Or use your own practice photo: the real models run in this tab.
02 · Model card
No general-purpose AI, no cloud. Each model does one narrow step, and every step’s output is kept so you can show the user why a word was chosen.
All models together, bundled with the crate
Network calls. No logs, no uploads
BIP39 words scored for every handwritten word
Penlock symbols scored for every one of 72 cells
03 · How it reads
PIPELINE A · BIP39
PIPELINE B · PENLOCK
04 · Integrate
Build a Scanner once, then scan each image. You get every word’s box, crop, raw text and probabilities, plus the checksum result.
use bitcoin_vision::words::{ScanOptions, Scanner};
// feature "bundled-models" embeds the ~24.7 MB of models
let scanner = Scanner::bundled()?; // load once, reuse
let photo = std::fs::read("practice-page.jpg")?;
let document = scanner.scan(&photo, ScanOptions::default())?.document();
for &i in &document.ordered_observations {
let word = &document.observations[i];
// word.selected, word.quad, word.candidates
}Hardware wallets
Ship the models with firmware and scan on the device. Tested in a Penlock app on the Passport Prime simulator.
Mobile wallets
Replace typing 12 words with one photo and a review step. Start from the Android example.
Penlock tools
Read paper shares back without retyping 72 symbols, then recombine any 2 of 3.
05 · In a hardware wallet
A Penlock app for Passport Prime, built at a hackathon, uses bitcoin-vision to read shares. So far it has run on the Passport Prime simulator, not yet on a real device. Small models and zero network access are what make it a fit.
STORAGE
About 24.7 MB of models
NETWORK
None, ever
UPDATES
Signed, through firmware
UX
Review, reveal, forget
06 · Limits
WHAT IT CAN’T DO YET
WHAT INTEGRATORS MUST DO