인터넷 없이 100% 작동하는 생존 비서 — Windows, Linux 및 macOS에서 사용 가능.
🇧🇷 포르투갈어(Português) · 🇺🇸 영어(English) · 🇪🇸 스페인어(Español)
인터넷, 전력 및 서비스가 중단되어도 이 키트는 노트북이나 USB 드라이브에서 계속 작동합니다:
- 📚 인용 출처가 명시된 실용 가이드(EN, PT, ES): 물, 불, 대피소, 식량, 원예 및 가축, 채집/낚시/사냥, 응급 처치 및 의학, 위생 및 수제 비누, 알코올(발효, 증류, 소독제 및 연료), 태양광 발전, 라디오 및 항해, 도구 및 매듭법, 정신 건강 및 공동체, 그리고 72시간 및 1년을 위한 체크리스트. - 🤖 로컬 AI: 자연어로 질문하면 답변하고, 출처를 인용합니다—사용자 자신의 컴퓨터에서 작동하며 (llama.cpp 또는 Ollama 사용); 인터넷으로 아무것도 전송되지 않습니다. - 🌐 Kiwix 오프라인 라이브러리: 의료 위키피디아, 재난 후 매뉴얼, Where There Is No Doctor, wikiHow, iFixit 등 — AI가 이들에서도 검색합니다. - 📱 웹 인터페이스: 브라우저에서 사용 가능하며, 로컬 네트워크를 통해 공유할 수 있습니다 (다른 휴대폰은 인터넷 연결 없이도 Wi-Fi를 통해 연결). - 🔍 AI 미사용 모드: 모델이 없더라도 Python을 사용하는 모든 PC에서 가이드 검색이 작동합니다.
⚠️ 면책 조항: 교육 콘텐츠입니다. 의사, 소방관 또는 응급 서비스의 대체품이 아닙니다. 건강 지침은 각 섹션에 인용된 공공 가이드라인(WHO, Red Cross/IFRC, AHA, CDC, Hesperian…)을 따릅니다.
질문 ──► 검색 키트 가이드 (BM25) ──────┐
└─► Kiwix 검색 (.zim 파일) ──────┼─► 로컬 언어 모델 ──► [1] [2] 출처와 함께 답변
└─► (모델 없음? 가장 관련성 높은 구절 표시)
파일 구조
| 파트 | 설명 | 위치 |
|---|
sobrevivencia.py + app/ | AI (파이썬 표준 라이브러리만 사용, pip install 불필요) 저장소 | repository |
| `knowledge/pt | en | es/, knowledge/extra/` |
runtime/llama.cpp/ | AI 모델을 실행하는 엔진 (준비자가 다운로드) | - |
models/*.gguf | 언어 모델 (1~5 GB) (준비자가 다운로드) | - |
runtime/kiwix-tools/ + zim/*.zim | Kiwix 서버 및 라이브러리 (준비자가 다운로드) | - |
runtime/python/ | 휴대용 Python (Python이 없는 PC용) (준비자가 다운로드) | - |
대용량 파일은 git에 커밋되지 않습니다 (.gitignore 참조): 따라서 저장소는 작게 유지되며, 모두 준비자를 통해 자신만의 키트를 구축합니다.
git clone https://github.com/sdalberto/ia-da-sobrevivencia.git
cd ia-da-sobrevivencia
시스템 설정 방법
| 시스템 | 실행 방법 |
|---|
| Windows | preparar-kit.bat 더블클릭 |
| macOS | preparar-kit.command 더블클릭 (최초 실행 시: 마우스 오른쪽 클릭 > 열기) |
| Linux | ./preparar-kit.sh --lang en |
준비자는 다음 항목들을 요청합니다:
AI 모델: leve(가벼움, 1 GB, 4 GB RAM), padrao(기본값, 2 GB, 8 GB RAM — 권장), forte(강함, 4.7 GB, 16 GB RAM).
Kiwix 라이브러리: minimo(~3–5 GB), recomendado(~25–40 GB) 또는 completo(100+ GB, 전체 위키피디아).
시스템: 이 컴퓨터 전용 또는 Windows + Linux + macOS(범용 USB 키트).
휴대용 Python: 기기에 Python이 설치되어 있지 않아도 키트를 열 수 있도록 합니다.
비대화형(Non-interactive) 실행:
python sobrevivencia.py --lang en prepare --model padrao --zims recomendado --os all --python
시스템 실행 방법
| 시스템 | 실행 방법 |
|---|
| Windows | iniciar.bat --lang en (또는 iniciar.bat 더블클릭 후 EN 키 누름) |
| macOS | iniciar.command |
| Linux | ./iniciar.sh --lang en |
브라우저가 http://127.0.0.1:8090으로 열립니다. PT/EN/ES 버튼을 사용하여 언제든지 언어를 전환할 수 있습니다. 기본 언어를 영어로 설정하려면, { "language": "en" } 내용으로 config/settings.local.json 파일을 생성합니다.
전체 폴더를 exFAT으로 포맷된 USB 드라이브 또는 외부 디스크에 복사합니다 (세 시스템 모두에서 작동하며 4 GB가 넘는 파일도 지원합니다).
python sobrevivencia.py --lang en chat # 터미널 채팅
python sobrevivencia.py --lang en ask "how do I make oral rehydration solution?"
python sobrevivencia.py --lang en search burn
...
Ollama: Ollama를 사용하는 경우, ollama pull qwen2.5:3b를 실행합니다.
— 이는 자동으로 감지됩니다. 로컬 OpenAI 호환 서버(LM Studio, llamafile, KoboldCpp, Jan)도 작동합니다: llm_url을 설정하세요.
Kiwix Desktop: Kiwix Desktop은 zim/ 폴더의 .zim 파일을 열 수 있습니다. AI가 로컬 Kiwix 서버를 사용하도록 하려면, config/settings.local.json에 { "kiwix_url": "http://127.0.0.1:<port>" }을 설정하세요.
Windows용 Kiwix Desktop 패키지(~150 MB)는 GitHub의 파일당 100 MB 제한을 초과하므로, 커밋하는 대신 **릴리스 에셋(Release asset)**으로 게시해야 합니다.
.md 또는 .txt 파일을 knowledge/extra/에 넣으세요 (가족 레시피, 지역 지도, 연락처, 장비 매뉴얼 등). 이 파일들은 인덱싱되며 AI에 의해 인용됩니다.
최소 사양(검색만): Python 3.8 이상을 사용하는 모든 PC.AI 사용 시: RAM 4 GB (경량 모델), 권장 8 GB; AVX2가 있는 x86-64 CPU 또는 Apple Silicon/ARM64. GPU는 필요하지 않습니다.디스크: 최소 키트의 경우 3 GB부터 전체 키트의 경우 100+ GB까지.
python -m unittest discover -s tests
코드: MIT. 가이드라인은 knowledge/에 있습니다.
: CC BY-SA 4.0. 준비자가 다운로드한 모델, Kiwix, llama.cpp 및 ZIM 파일은 자체 라이선스를 가집니다. 기본 모델(Qwen2.5 3B)은 Qwen Research License를 사용하며, 상업적 용도로는 leve 또는 forte(Apache 2.0)를 선택하세요.