离线生存助手发布 本地 LLM 搭配 Kiwix 从 U 盘运行
该项目提供一个完全离线的生存知识助手,在 Windows、Linux 和 macOS 上通过 llama.cpp 或 Ollama 运行本地模型,并检索 Kiwix 离线资料库(含医学维基百科、Where There Is No Doctor、iFixit 等)后带引用作答。它附带多语言实用指南与可局域网共享的网页界面,无模型时仍可用 Python 做纯检索。
报道正文
本文目录10 个章节
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)