Open source · MIT · Apple Silicon Macs
Everything you'd look up, on a drive you can hold.
An AI assistant, Wikipedia, medical and repair guides, and maps with directions. One external SSD. Works on your Mac with the internet off.
What's inside
Plug in. Double-click START-HERE. A page opens with four tabs.
Ask
Ask a question in plain words. The answer comes from the library, with numbered sources you can open. Works even with the AI off.
AI chat
A capable open model running on your Mac. Attach a photo of a rash, a part or a label and ask about it.
Library
Wikipedia with images, medical references, iFixit, Army manuals and preparedness guides. All searchable.
Map
Search an address, get driving or walking directions, or find the nearest hospital or pharmacy.
A 2 TB external SSD and an Apple Silicon Mac. 32 GB of memory is ideal; smaller Macs use the small model.
Copy the kit onto the drive and double-click SETUP. It takes a few hours and checks every file.
Turn Wi-Fi off and double-click START-HERE.command. Everything should still answer.
Every two or three months, double-click SETUP again. Only what changed downloads.
The kit builder
Choose what goes on your drive.
Start from a preset, then switch sources on or off. You get a setup prompt with your picks built in, and a kit.json to drop on the drive.
Loading sources…
Set it up with any AI chat.
I want to set up Tinfoil Kit on my Mac. It's an offline AI assistant, an offline library (Wikipedia, medical and repair guides) and offline maps, all on an external drive, for when the internet is down. The project is at https://github.com/tudor-city-ventures/tinfoilkit. Read its README and GUIDE, then walk me through setup one step at a time: 1. Which drive to buy and how to format it. 2. How to download the kit onto the drive and run SETUP.command, which takes a few hours the first time. 3. How to check that it works with Wi-Fi off. 4. How to keep it updated every few months. I'm not a programmer. Tell me exactly what to click or paste, and wait for me to confirm each step before moving on.
Help me build my own offline kit for an internet outage, on an external SSD. Principles: - Everything works with zero internet: local AI models, an offline library and offline maps, served on localhost and opened in a browser. - One config file lists every source. One command refreshes everything every 2-3 months. It resumes interrupted downloads, verifies checksums, and keeps the old version until the new one checks out. - AI: a few open-weight models sized to my computer's memory (one capable default, one small and fast), run with llama.cpp's server. - Library: Kiwix ZIM files (Wikipedia, medical references, iFixit, preparedness guides) served by kiwix-serve with full-text search. - The AI answers from the library: it searches it, reads the top passages and cites them. It still works with the AI off. - Maps: vector tiles for my region plus a low-detail world map, offline address search and offline directions. The AI can use them as tools. - An offline self-test, and a one-page printed guide kept with the drive. - Use exFAT so any computer can read the drive, and avoid symlinks. First ask me about my computer, drive size, region and priorities. Then propose a plan before writing any code.
Questions
Before you fill a drive.
Does anything leave my Mac?
No. Once the drive is filled, every part runs on your Mac at 127.0.0.1 with no account and no telemetry. The only time it goes online is when you run SETUP or ./kit sync to download updates, and then it only talks to the sources listed in kit.json.
What do I need?
An Apple Silicon Mac (M1 or newer) and an external SSD. 32 GB of memory runs the capable model; smaller Macs use the small one. The recommended kit is about 300 GB, so a 2 TB drive leaves room to grow. The kit builder above shows the total for your picks.
Can I trust the AI's answers?
Treat it like a well-read friend, not a doctor. In the Ask tab it answers from the library and numbers its sources, so you can open the page it used and check. For anything serious, read the source itself.
Can my family use it from their phones?
Yes. Start it with --share and any phone on the same Wi-Fi or hotspot can open the page. No internet is needed for that, only a local network.
How long does it run on battery?
The big model uses a lot of power: expect a couple of hours of active use on a laptop. The small model uses much less, and the Library tab with the AI off uses almost nothing. A USB-C power station and a folding solar panel keep it going.
What about Windows or Linux?
The Mac is the supported setup for now. They're a fallback if the Mac is gone: on an exFAT drive, a Windows PC runs the library and a slower AI with the included launcher, and Linux runs it from Terminal. The map is Mac-only, and these paths are less tested.
Is all this content legal to copy?
Yes. The library comes from Kiwix, which packages openly licensed sites like Wikipedia, WikiMed and iFixit, and US government guides. The AI models are open-weight models published for anyone to run.
Open source, MIT license
Read every line. Change anything. Keep it forever.
No account, no subscription, no tracking. The sync script, the launcher and the page are plain files you can inspect, and your drive keeps working no matter what happens to us.