Offline Survival Assistant Runs Local LLM and Kiwix from a USB Stick
The project delivers a fully offline survival-knowledge assistant that runs local models via llama.cpp or Ollama on Windows, Linux and macOS, retrieving from Kiwix offline libraries (medical Wikipedia, Where There Is No Doctor, iFixit and more) and answering with citations. It bundles multilingual practical guides and a LAN-shareable web UI, with a Python-only retrieval mode when no model is installed.
Full Report
Contents10 sections
IA da Sobrevivência
Um assistente de sobrevivência que funciona 100% sem internet — no Windows, Linux e macOS.
Se a internet, a energia e os serviços pararem, este kit continua funcionando num notebook ou pendrive:
- 📚 Guias práticos com fontes citadas (PT, EN e ES): água, fogo, abrigo, comida, horta e criação, coleta/pesca/caça, primeiros socorros e medicina, higiene e sabão caseiro, álcool (fermentação, destilação, antisséptico e combustível), energia solar, rádio e navegação, ferramentas e nós, saúde mental e comunidade, e checklists para 72 horas e 1 ano.
- 🤖 IA local que responde qualquer pergunta em linguagem natural, citando as fontes — roda no próprio computador (llama.cpp ou Ollama), nada vai para a internet.
- 🌐 Bibliotecas offline do Kiwix: Wikipedia de medicina, manuais pós-desastre, Where There Is No Doctor, wikiHow, iFixit e outras — a IA busca nelas também.
- 📱 Interface web que abre no navegador e pode ser compartilhada na rede local (outros celulares acessam pelo Wi-Fi, mesmo sem internet).
- 🔍 Modo sem IA: mesmo sem modelo baixado, a busca nos guias funciona em qualquer PC com Python.
⚠️ Aviso: conteúdo educativo. Não substitui médicos, bombeiros ou defesa civil. As orientações de saúde seguem diretrizes públicas (OMS, Cruz Vermelha/IFRC, AHA, Ministério da Saúde, CDC, Hesperian…) citadas em cada seção.
Como funciona
Pergunta ──► busca nos guias do kit (BM25) ─┐
└─► busca no Kiwix (arquivos .zim) ─┼─► modelo de linguagem local ──► resposta com [1] [2] fontes
└─► (sem modelo? mostra os trechos mais relevantes)| Peça | O que é | Onde fica |
|---|---|---|
sobrevivencia.py + app/ | A IA (só biblioteca padrão do Python, sem pip install) | repositório |
| `knowledge/pt | en | es/` |
knowledge/extra/ | Seus documentos .md/.txt (entram na busca e na IA) | repositório |
runtime/llama.cpp/ | Motor que roda o modelo de IA | baixado pelo preparador |
models/*.gguf | Modelo de linguagem (1–5 GB) | baixado pelo preparador |
runtime/kiwix-tools/ + zim/*.zim | Servidor e bibliotecas do Kiwix | baixado pelo preparador |
runtime/python/ | Python portátil (para PCs sem Python) | baixado pelo preparador |
Os arquivos grandes não vão para o git (veja .gitignore): o repositório fica leve, e cada pessoa monta o seu kit com o preparador.
Começo rápido
1. Baixe o repositório
git clone https://github.com/sdalberto/ia-da-sobrevivencia.git
cd ia-da-sobrevivencia2. Prepare o kit (com internet, só uma vez)
| Sistema | Como rodar |
|---|---|
| Windows | clique duas vezes em preparar-kit.bat |
| macOS | clique duas vezes em preparar-kit.command (1ª vez: botão direito › Abrir) |
| Linux | ./preparar-kit.sh |
O preparador pergunta:
- Modelo de IA:
leve(1 GB, PCs com 4 GB de RAM),padrao(2 GB, 8 GB de RAM — recomendado),forte(4,7 GB, 16 GB de RAM). - Bibliotecas Kiwix:
minimo(~3–5 GB),recomendado(~25–40 GB) oucompleto(100+ GB, inclui a Wikipedia inteira). - Sistemas: só este computador, ou Windows + Linux + macOS (kit universal para pendrive).
- Python portátil: para o kit abrir em computadores sem Python.
Sem perguntas (ex.: para automatizar):
python sobrevivencia.py prepare --model padrao --zims recomendado --os all --pythonSe faltar Python para rodar o preparador: instale em https://www.python.org/downloads/ (no Windows marque Add python.exe to PATH). Depois o kit leva um Python portátil junto.
3. Use (sem internet)
| Sistema | Como abrir |
|---|---|
| Windows | iniciar.bat |
| macOS | iniciar.command |
| Linux | ./iniciar.sh |
O navegador abre em http://127.0.0.1:8090. Para inglês ou espanhol: iniciar.bat --lang en / ./iniciar.sh --lang es (ou use os botões PT/EN/ES na interface).
4. Leve no pendrive
Copie a pasta inteira para um pendrive ou HD externo (formatado em exFAT, que funciona nos três sistemas e aceita arquivos com mais de 4 GB). Pronto: é só abrir o iniciar correspondente em qualquer computador.
Outras formas de usar
python sobrevivencia.py chat # conversa no terminal
python sobrevivencia.py ask "como fazer soro caseiro?"
python sobrevivencia.py search queimadura # busca rápida nos guias
python sobrevivencia.py status # o que está instalado e ativo
python sobrevivencia.py start --host 0.0.0.0 # compartilhar na rede local (Wi-Fi)
python sobrevivencia.py prepare --search survival # descobrir mais bases no catálogo KiwixCompartilhar com a comunidade: com --host 0.0.0.0, qualquer celular conectado ao mesmo roteador (mesmo sem internet) abre o endereço mostrado no terminal, ex.: http://192.168.0.10:8090.
Usando Ollama em vez do llama.cpp
Se você já usa Ollama: ollama pull qwen2.5:3b e pronto — a IA detecta o Ollama sozinha. Para outro modelo, crie config/settings.local.json:
{ "ollama_model": "llama3.2:3b" }Também funciona com qualquer servidor compatível com a API da OpenAI rodando localmente (LM Studio, llamafile, KoboldCpp, Jan): ajuste llm_url.
Usando o Kiwix Desktop
O Kiwix Desktop abre os arquivos .zim da pasta zim/ com uma interface de leitura completa. Se preferir que a IA use o servidor do Kiwix Desktop (menu Servidor local / Local Kiwix Server), coloque a porta dele em config/settings.local.json:
{ "kiwix_url": "http://127.0.0.1:8080" }💡 O instalador do Kiwix Desktop para Windows (~150 MB) é maior que o limite de 100 MB por arquivo do GitHub. Para distribuí-lo junto, publique-o como anexo de uma Release do repositório (limite de 2 GB por arquivo) em vez de fazer commit.
Adicionando seu próprio conhecimento
Coloque arquivos .md ou .txt em knowledge/extra/ (receitas da família, mapa do bairro, contatos, manuais de equipamentos, bulas). Eles entram no índice e a IA passa a citá-los. Para traduzir ou ampliar os guias oficiais, edite knowledge/<idioma>/ mantendo os mesmos nomes de arquivo nos três idiomas.
(注:更多技术实现细节与完整 API 文档请查阅原项目 README)