Repolode
Submit
elhajahmadj

elhajahmadj/offline-emergency-library

A one-command installer that downloads an offline emergency kit: local AI chat, Wikipedia, regional maps, and survival, repair and medical references.

View on GitHub
Stars
167
Forks
18
Open issues
7
Last commit
12 hours ago

What is it?

Offline Emergency Library is a PowerShell and Bash installer that fetches a self-contained reference kit for use without internet access. The user is asked only for a save location, after which the script downloads a local AI chat built on llama.cpp with 3B, 7B and 8B models, a GPT4All document Q&A tool, full English Wikipedia in Kiwix format, and offline street maps for a chosen region (US by default).

The kit also includes Kiwix-readable archives on repair (iFixit), DIY and building (Appropedia), medical and survival topics, plus public-domain US Army manuals, medical and canning guides as PDFs. Maps come with a bundled desktop viewer and an Android APK, and optional extras include browser-based maps and Khan Academy or Kolibri learning content.

The installer writes an HTML and Markdown index of the drive, a checksum file, and a CHECK-DRIVE script that re-verifies files later. Downloads resume if interrupted, and a lite mode reduces the size for smaller drives. The full library is roughly 85 GB.

Key features

  • 01Local AI chat that runs on CPU, with optional GPU acceleration
  • 02Document Q&A over your own PDFs with citations via GPT4All
  • 03Full English Wikipedia and many topic archives readable offline with Kiwix
  • 04Offline maps for any country or region, with a desktop viewer and Android app
  • 05Checksum file and verification script to detect damaged files on the drive

Use cases

  • Keeping a reference library and offline AI on a USB drive for power or internet outages
  • Carrying offline maps and navigation resources for remote travel without cellular coverage
  • Storing repair, first aid and survival manuals on an old PC in a home emergency kit
  • Building a portable knowledge archive for schools or communities with limited connectivity

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/elhajahmadj/offline-emergency-library.git
  2. 2

    Enter the project folder

    cd offline-emergency-library
  3. 3

    Run the installer on macOS or Linux and pick a save location (Windows users can double-click install.bat instead)

    ./get-offline-library.sh -d /path/to/drive

Things to know

  • The metadata license is NOASSERTION, so the project's license is unclear.
  • The full download is about 85 GB and can take several hours.
  • Some bundled guides are CC BY-NC-SA 4.0, which is non-commercial.

In collections

Claude Code tools, skills & pluginsRun LLMs locally

Topics

#offline-ai#wikipedia#offline-maps#emergency-preparedness#kiwix#llama-cpp#survival#powershell#claude#claude-code

FAQ

What is offline-emergency-library?
A one-command installer that downloads an offline emergency kit: local AI chat, Wikipedia, regional maps, and survival, repair and medical references. Offline Emergency Library is a PowerShell and Bash installer that fetches a self-contained reference kit for use without internet access. The user is asked only for a save location, after which the script downloads a local AI chat built on llama.cpp with 3B, 7B and 8B models, a GPT4All document Q&A tool, full English Wikipedia in Kiwix format, and offline street maps for a chosen region (US by default).
Is offline-emergency-library free to use? What license does it have?
offline-emergency-library is open source under the Other license. Check the license terms before using it in commercial products.
Is offline-emergency-library still maintained?
Actively maintained. The last commit to offline-emergency-library was on Nov 6, 2026.
What can I use offline-emergency-library for?
Keeping a reference library and offline AI on a USB drive for power or internet outages Carrying offline maps and navigation resources for remote travel without cellular coverage Storing repair, first aid and survival manuals on an old PC in a home emergency kit Building a portable knowledge archive for schools or communities with limited connectivity
How do I install offline-emergency-library?
Clone the repository: git clone https://github.com/elhajahmadj/offline-emergency-library.git Enter the project folder: cd offline-emergency-library Run the installer on macOS or Linux and pick a save location (Windows users can double-click install.bat instead): ./get-offline-library.sh -d /path/to/drive
Where can I get offline-emergency-library?
The source code and installation instructions are on GitHub: https://github.com/elhajahmadj/offline-emergency-library

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects