Knowmad is a fully offline, air‑gapped survivalist AI designed to travel with you and keep you capable no matter how far you roam. Running entirely from a portable drive, it gives you practical, hands‑on knowledge for fixing machines, troubleshooting electronics, building shelters, identifying plants, purifying water, navigating terrain, and staying alive when the grid goes dark. Knowmad combines a local large‑language model with an embedded library of field manuals, repair guides, and wilderness skills, letting you ask questions and get clear, actionable answers even with zero power, zero signal, and zero internet. It’s your pocket‑sized field companion — a wandering mind built for wandering lives.
NOTE: This project was generated with Cookiecutter along with @clamytoe's toepack project template.
cd Projects
git clone https://github.com/clamytoe/knowmad.git
cd knowmadIf you are an Anaconda user, this command will get you up to speed with the base installation.
conda env create -f environment.yml
conda activate knowmad
uv sync
uv sync --group devuv run knowmadOnce fully deployed:
uv run knowmad ask "How do I build a solar still?"The output should be: Successfully installed your project file: knowmad
Contributions are welcomed.
Tests can be run with with uv run pytest -v, please ensure that all tests are passing and that you've checked your code with the following packages before submitting a pull request:
- black
- mypy
- pytest-cov
- ruff
I am not adhering to them strictly, but try to clean up what's reasonable.
Distributed under the terms of the MIT license, "knowmad" is free and open source software.
If you encounter any problems, please file an issue along with a detailed description.
- v0.1.0 Initial commit.