Repository navigation
Run OpenBridge on Your Computer
This page shows you how to use OpenBridge as a single file on your own computer, with nothing to install and no internet needed. It is for anyone, including people who are not comfortable with computers.
OpenBridge is a prototype. The rules are drafts that experts have not checked yet. Results are estimates, not decisions.
- A computer with a web browser: Chrome, Edge, Firefox, or Safari.
- Internet only for the download. After that, OpenBridge works offline.
- Go to the Releases page. Open the OpenBridge repository on GitHub and choose Releases on the right side. If there are no releases yet, the first one has not been published. Check back later, or ask the person who sent you here for a copy.
-
Download the local file. Under the newest release, open Assets and download the file
named
openbridge-local-vfollowed by a version number and.zip(for exampleopenbridge-local-v0.2.0.zip). - Unzip it. On Windows, right-click the file and choose Extract All. On a Mac, double-click it.
-
Open it. In the new folder, double-click
OpenBridge.html. It opens in your web browser. - Use it. Follow Using OpenBridge.
Each release also has a file called SHA256SUMS.txt. It lists a "fingerprint" (checksum) for every
download. If your fingerprint matches, the file was not changed or damaged on the way. You can skip
this, but it is a good habit.
Open a terminal in the folder with the zip file and run the command for your computer:
| Computer | Command |
|---|---|
| Windows | certutil -hashfile openbridge-local-v0.2.0.zip SHA256 |
| Mac | shasum -a 256 openbridge-local-v0.2.0.zip |
| Linux | sha256sum openbridge-local-v0.2.0.zip |
Use your real file name. Compare the long string it prints with the line for that file in
SHA256SUMS.txt. They should be the same.
For extra proof (optional, for technical users). Each download is also signed by GitHub to show it was built by the project's release workflow from a specific commit. With the GitHub CLI installed, run:
gh attestation verify openbridge-local-v0.2.0.zip --repo UbiquitousKiwi/OpenBridgeIt prints "Verification succeeded" when the file is genuine.
-
It opens in the wrong program (like a text editor). Right-click
OpenBridge.html, choose Open with, and pick your web browser. - It shows the zip contents instead of the app. Unzip first, then open the file from the new folder, not from inside the zip.
- A blank page or a warning on a work or school computer. Some managed browsers block pages opened from a file. Try a different browser, or ask your IT team.
-
Saving does nothing. Your browser puts the saved file (
openbridge-progress.json) in your Downloads folder. Check there. Some browsers ask where to save it first.
If you are still stuck, email openbridge@starlingtek.com, or open a "Bug report" issue on the OpenBridge GitHub page.
- No automatic updates. The file never changes by itself. Rules change every year, so an old copy can give out-of-date results.
- Organization settings do not apply. The local file always starts in the normal mode and clears itself after 3 minutes of no activity.
- The same privacy. It makes no internet requests at all. Closing the tab erases your answers.
- Download the newest
openbridge-local-v...zipfrom Releases, as above. - Unzip it and use the new
OpenBridge.html. You can delete the old folder. - To see which version you have, open
BUILD-INFO.jsonin the folder. It lists the version and the rules data version.
Saved files from an older copy still open in the new one. Your answers fill back in, and pressing See my results checks them against the newer rules.
OpenBridge is a prototype. Its rules are drafts that experts have not verified yet, and results are
estimates, not decisions. It is not legal advice. Need help applying for benefits? Call 211 or visit
211.org. This wiki is edited in the wiki/ folder of the repository.
Questions: openbridge@starlingtek.com.
Start here
Use OpenBridge
- Using OpenBridge
- Understanding your results
- Guide for navigators
- Privacy and your data
- Run it on your computer
- Host it for others
- Use it with an AI assistant
Help without code
- Ways to help
- Review rules as an expert
- Record a test case
- Report a rule problem
- Translate OpenBridge
- Test accessibility
- Community rule toolkit
Rules and policy (with code)
- How the rules engine works
- State adapters
- Add or change a rule
- Add a new state
- Golden test cases
- Yearly data updates
Developers