A survival assistant that works 100% without internet — on Windows, Linux and macOS.
🇧🇷 Português · 🇺🇸 English · 🇪🇸 Español
If the internet, power and services go down, this kit keeps working on a laptop or USB drive:
- 📚 Practical guides with cited sources (EN, PT, ES): water, fire, shelter, food, gardening and livestock, foraging/fishing/hunting, first aid and medicine, hygiene and homemade soap, alcohol (fermentation, distillation, antiseptic and fuel), solar power, radio and navigation, tools and knots, mental health and community, and checklists for 72 hours and 1 year.
- 🤖 Local AI that answers any question in natural language, citing its sources — it runs on your own computer (llama.cpp or Ollama); nothing goes to the internet.
- 🌐 Kiwix offline libraries: medical Wikipedia, post-disaster manuals, Where There Is No Doctor, wikiHow, iFixit and more — the AI searches them too.
- 📱 Web interface in your browser, shareable over the local network (other phones connect via Wi-Fi, even with no internet).
- 🔍 No-AI mode: even without a model, guide search works on any PC with Python.
⚠️ Disclaimer: educational content. It does not replace doctors, firefighters or emergency services. Health guidance follows public guidelines (WHO, Red Cross/IFRC, AHA, CDC, Hesperian…) cited in each section.
Question ──► search kit guides (BM25) ──────┐
└─► search Kiwix (.zim files) ──────┼─► local language model ──► answer with [1] [2] sources
└─► (no model? shows the most relevant passages)
| Part | What it is | Where |
|---|---|---|
sobrevivencia.py + app/ |
The AI (Python standard library only, no pip install) |
repository |
| `knowledge/pt | en | es/` |
knowledge/extra/ |
Your .md/.txt documents (searched and cited by the AI) |
repository |
runtime/llama.cpp/ |
Engine that runs the AI model | downloaded by the preparer |
models/*.gguf |
Language model (1–5 GB) | downloaded by the preparer |
runtime/kiwix-tools/ + zim/*.zim |
Kiwix server and libraries | downloaded by the preparer |
runtime/python/ |
Portable Python (for PCs without Python) | downloaded by the preparer |
Large files are not committed to git (see .gitignore): the repository stays small and everyone builds their own kit with the preparer.
git clone https://github.com/sdalberto/ia-da-sobrevivencia.git
cd ia-da-sobrevivencia| System | How to run |
|---|---|
| Windows | double-click preparar-kit.bat |
| macOS | double-click preparar-kit.command (first time: right-click › Open) |
| Linux | ./preparar-kit.sh --lang en |
The preparer asks for:
- AI model:
leve(light, 1 GB, 4 GB RAM),padrao(default, 2 GB, 8 GB RAM — recommended),forte(strong, 4.7 GB, 16 GB RAM). - Kiwix libraries:
minimo(~3–5 GB),recomendado(~25–40 GB) orcompleto(100+ GB, full Wikipedia). - Systems: this computer only, or Windows + Linux + macOS (universal USB kit).
- Portable Python: so the kit opens on computers without Python.
Non-interactive:
python sobrevivencia.py --lang en prepare --model padrao --zims recomendado --os all --python| System | How to open |
|---|---|
| Windows | iniciar.bat --lang en (or double-click iniciar.bat and press EN) |
| macOS | iniciar.command |
| Linux | ./iniciar.sh --lang en |
Your browser opens http://127.0.0.1:8090. Switch language anytime with the PT/EN/ES buttons. To make English the default, create config/settings.local.json with { "language": "en" }.
Copy the whole folder to a USB drive or external disk formatted as exFAT (works on all three systems and supports files over 4 GB).
python sobrevivencia.py --lang en chat # terminal chat
python sobrevivencia.py --lang en ask "how do I make oral rehydration solution?"
python sobrevivencia.py --lang en search burn
python sobrevivencia.py status
python sobrevivencia.py start --host 0.0.0.0 # share on the local network
python sobrevivencia.py prepare --search survival # find more Kiwix librariesOllama: if you use Ollama, run ollama pull qwen2.5:3b — it is detected automatically. Any local OpenAI-compatible server (LM Studio, llamafile, KoboldCpp, Jan) also works: set llm_url.
Kiwix Desktop: Kiwix Desktop can open the .zim files in zim/. To let the AI use its Local Kiwix Server, set { "kiwix_url": "http://127.0.0.1:<port>" } in config/settings.local.json. The Windows Kiwix Desktop package (~150 MB) exceeds GitHub's 100 MB per-file limit — publish it as a Release asset instead of committing it.
Drop .md or .txt files in knowledge/extra/ (family recipes, local maps, contacts, equipment manuals). They are indexed and cited by the AI.
- Minimum (search only): any PC with Python 3.8+.
- With AI: 4 GB RAM (light model), 8 GB recommended; x86-64 CPU with AVX2 or Apple Silicon/ARM64. No GPU needed.
- Disk: 3 GB (minimal kit) to 100+ GB (full kit).
python -m unittest discover -s testsCode: MIT. Guides in knowledge/: CC BY-SA 4.0. Models, Kiwix, llama.cpp and ZIM files downloaded by the preparer have their own licenses. The default model (Qwen2.5 3B) uses the Qwen Research License; for commercial use choose leve or forte (Apache 2.0).