Installation
Install reza via npm, pip, or run from source. Works on macOS, Linux, and Windows.
Installation
via npm (recommended for JS/Node developers)
npm install -g @swebreza/rezaAutomatically installs the Python backend via pip. Requires Python 3.8+.
via pip (recommended for Python developers)
pip install rezavia npx (no global install)
npx @swebreza/reza init
npx @swebreza/reza queryFrom source
git clone https://github.com/swebreza/reza
cd reza
pip install -e .Requirements
| Requirement | Version | Notes |
|---|---|---|
| Python | 3.8+ | Core runtime — always required |
| pip | any | For pip install reza |
| Node.js | 14+ | Only if installing via npm |
| watchdog | 3.0+ | Only for reza watch (auto-installed) |
All Python dependencies install automatically.
Per-Project Setup
cd your-project
reza initThis:
- Creates
.reza/context.db - Scans all source files and extracts purposes from docstrings/comments
- Detects your project's language and framework
- Installs a pre-commit git hook
- Adds a comment to
.gitignore(you decide whether to commit.reza/)
Should I commit .reza/?
Team projects: Yes — commit it. Everyone gets shared context and session history.
Solo projects: Optional. The DB regenerates quickly with reza init.