离线生存助手发布 本地 LLM 搭配 Kiwix 从 U 盘运行

原标题:Offline survival assistant – local LLM and Kiwix, runs from a USB stick
58AI 研判分

该项目提供一个完全离线的生存知识助手,在 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çaO que éOnde fica
sobrevivencia.py + app/A IA (só biblioteca padrão do Python, sem pip install)repositório
`knowledge/ptenes/`
knowledge/extra/Seus documentos .md/.txt (entram na busca e na IA)repositório
runtime/llama.cpp/Motor que roda o modelo de IAbaixado pelo preparador
models/*.ggufModelo de linguagem (1–5 GB)baixado pelo preparador
runtime/kiwix-tools/ + zim/*.zimServidor e bibliotecas do Kiwixbaixado 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

BASH
git clone https://github.com/sdalberto/ia-da-sobrevivencia.git
cd ia-da-sobrevivencia

2. Prepare o kit (com internet, só uma vez)

SistemaComo rodar
Windowsclique duas vezes em preparar-kit.bat
macOSclique duas vezes em preparar-kit.command (1ª vez: botão direito › Abrir)
Linux./preparar-kit.sh

O preparador pergunta:

  1. 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).
  2. Bibliotecas Kiwix: minimo (~3–5 GB), recomendado (~25–40 GB) ou completo (100+ GB, inclui a Wikipedia inteira).
  3. Sistemas: só este computador, ou Windows + Linux + macOS (kit universal para pendrive).
  4. Python portátil: para o kit abrir em computadores sem Python.

Sem perguntas (ex.: para automatizar):

BASH
python sobrevivencia.py prepare --model padrao --zims recomendado --os all --python

Se 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)

SistemaComo abrir
Windowsiniciar.bat
macOSiniciar.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

BASH
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 Kiwix

Compartilhar 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:

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:

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)