Installation
Prerequisites
| Dependency | macOS | Ubuntu/Debian | Windows |
|---|---|---|---|
| Docker | brew install colima && colima start |
sudo apt install docker.io docker-compose-plugin |
Docker Desktop |
| Ollama | brew install ollama && ollama serve |
curl -fsSL https://ollama.com/install.sh \| sh |
Ollama installer |
| Python 3.11+ | brew install python@3.12 |
sudo apt install python3.12 python3.12-venv |
python.org |
Install Knowledge Master
From PyPI (recommended)
pip install knowledge-master
Or with pipx for isolated install:
pipx install knowledge-master
From source
git clone https://github.com/subzone/knowledge-master.git
cd knowledge-master
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
Verify installation
km --help
You should see the list of available commands.
First run
km start
This will:
- Start FalkorDB and Postgres containers (Docker)
- Pull the
nomic-embed-textembedding model (Ollama, ~274MB one-time download) - Initialize the graph schema
You're ready
If you see "Knowledge Master is ready!", proceed to Quick Start.
Troubleshooting
| Issue | Fix |
|---|---|
km: command not found |
Ensure your Python bin is in PATH, or use python -m knowledge_master |
| Docker not running | macOS: colima start ยท Linux: sudo systemctl start docker |
| Ollama not found | Install from https://ollama.com |
| Port 6379 already in use | Another Redis/FalkorDB is running. Stop it or change port in docker-compose.yml |