🛟 Offline Emergency Library

A complete, offline, no-internet "survival knowledge" kit you can download with a single
command. Built for emergencies, grid-down scenarios, remote areas, or anyone who wants a
self-contained offline reference + AI on a drive.

One command asks you only one thing — where to save the files — then downloads
everything and writes all the documentation (Markdown and HTML). After that, it all
works with no internet.

What you get

Everything is free and legally redistributable — open-weight AI models, openly-licensed
Kiwix archives, and public-domain US-government manuals. No piracy.

📦 Storage requirements — what kind of drive do I need?

The full library is ~60 GB. Always leave headroom (for the AI's temp files, GPT4All
install, and future updates), so plan for more than 60 GB.

Tip: If you only want the reference material (no AI), you can skip the big pieces
with -SkipModels and still get Wikipedia, maps, and all manuals in ~30 GB. If you also
skip Wikipedia and maps (-SkipWikipedia -SkipMaps), the AI + manuals fit in ~20 GB.

💻 Hardware requirements — what machine do I need to USE it?

To download: any 64-bit Windows, macOS, or Linux computer with internet.

• Windows: uses curl + PowerShell (both built in).
• macOS/Linux: uses curl + tar (built in); unzip enables the desktop map viewer.

Downloading ~60 GB can take a few hours.

To use it afterward (offline):

Key points:

• No GPU is required for the AI — it runs on an ordinary CPU (just slower). A 6 GB GPU
  is a bonus.
• The AI engine ships x64, ARM64, and Vulkan-GPU builds, so it runs on Intel/AMD and
  ARM Windows machines.
• The whole kit is portable — copy the OfflineLibrary folder to any PC and use it.

🚀 How to download (pick one)

A) Easiest — double-click install.bat

Download/clone the repo, then double-click install.bat. It opens a window, asks you
where to save, and downloads everything. No commands, no PowerShell knowledge needed.
(If Windows SmartScreen warns, click More info → Run anyway.)

B) In Claude Code (one prompt)

Install this repo's skill, then say:

/offline-emergency-library

It will ask only: "Where would you like to save these files?" — then download
everything.

C) Windows — PowerShell one-liner (no Claude needed)

irm https://raw.githubusercontent.com/elhajahmadj/offline-emergency-library/main/Get-OfflineLibrary.ps1 | iex

It will prompt you for the save location, then download everything.

D) macOS / Linux — one-liner

curl -fsSL https://raw.githubusercontent.com/elhajahmadj/offline-emergency-library/main/get-offline-library.sh | bash

It will prompt you for the save location, then download everything.
(Requires curl and tar; unzip enables the desktop map viewer. All are standard.)

E) Clone and run

git clone https://github.com/elhajahmadj/offline-emergency-library.git
cd offline-emergency-library
# Windows:
./Get-OfflineLibrary.ps1 -Destination "E:\"
# macOS / Linux:
./get-offline-library.sh -d /path/to/drive

All methods are resumable — if the download is interrupted, run the same command again
and it continues where it left off.

Platform support

🗺️ Choosing your map region (optional — default is US)

The maps default to the United States. To download a different country, region, or
continent, add -Region (Windows) / --region (macOS/Linux):

# Windows
./Get-OfflineLibrary.ps1 -Destination "E:\" -Region France
./Get-OfflineLibrary.ps1 -Destination "E:\" -Region "Germany,Austria"
./Get-OfflineLibrary.ps1 -Destination "E:\" -Region Europe      # whole continent
# macOS / Linux
./get-offline-library.sh -d /mnt/usb --region Japan
./get-offline-library.sh -d /mnt/usb --region US_texas          # a sub-region
./get-offline-library.sh -d /mnt/usb --region world             # everything (hundreds of GB!)

Not sure of the name? List what's available (no download):

./Get-OfflineLibrary.ps1 -ListRegions              # Windows: all countries/regions
./Get-OfflineLibrary.ps1 -ListRegions -Filter US   # Windows: sub-regions of the US
./get-offline-library.sh --list-regions            # macOS/Linux: all
./get-offline-library.sh --list-regions France     # macOS/Linux: sub-regions of France

Accepts a country (France), several ("Germany,Austria"), a continent (Europe,
Africa, Asia, North-America, South-America, Central-America,
Australia-Oceania), a sub-region (US_texas, Germany_bayern), or world.
Size varies: US ≈17 GB, a small country <1 GB, a continent tens of GB, world
hundreds of GB — the installer prints the size and warns before large downloads.

🧭 After it finishes

The installer writes a README.html at the root of the download folder — a full,
clickable index of every guide, document, manual, archive, app and data file on the
drive (auto-generated by scanning the folders). Open that first for a complete map of
everything, or START-HERE.html for a guided intro.

(You can regenerate the index any time with build-readme-index.ps1 -Root "<folder>".)

Both pages link to each component's guide:

• AI-Offline\HOW-TO-RUN-OFFLINE-AI.html — run the offline AI chat
• AI-Offline\DocReader-GPT4All\HOW-TO-ASK-YOUR-DOCS.html — ask AI about your PDFs
• Kiwix-Reader\HOW-TO-USE-KIWIX.html — read the .zim archives
• OsmAnd\HOW-TO-VIEW-MAPS.html — view maps on a PC (no phone) or phone
• Phone-Apps\USE-ON-PHONE.html — port the library to a phone
• Manuals\READ-ME-FIRST.html and Medical\READ-ME-FIRST.html
• Manuals\Radio-Communications\RADIO-GUIDE.html — emergency radio comms

Options (optional, for small drives)

Example: ./Get-OfflineLibrary.ps1 -Destination "F:\" -SkipWikipedia -SkipMaps

⚠️ Disclaimers

• Offline AIs and older manuals can be wrong or outdated. Verify anything
  safety-critical (medical, electrical, structural) against authoritative sources when
  possible. This kit is reference material, not professional advice.
• Modern copyrighted code books (NEC/UPC) and brand auto manuals (Haynes/Chilton) are
  not included. Their topics are covered by the openly-licensed iFixit/Appropedia
  archives and public-domain Army technical manuals.
• Respect your local laws for radio transmission (listening is always fine; see the radio
  guide).

License

Code and documentation in this repo: MIT (see LICENSE). Downloaded content retains
its original licenses (open-weight model licenses, CC licenses for Kiwix content, public
domain for US-government works).