Installation

Install reza via npm, pip, or run from source. Works on macOS, Linux, and Windows.

Installation

npm install -g @swebreza/reza

Automatically installs the Python backend via pip. Requires Python 3.8+.

pip install reza

via npx (no global install)

npx @swebreza/reza init
npx @swebreza/reza query

From source

git clone https://github.com/swebreza/reza
cd reza
pip install -e .

Requirements

RequirementVersionNotes
Python3.8+Core runtime — always required
pipanyFor pip install reza
Node.js14+Only if installing via npm
watchdog3.0+Only for reza watch (auto-installed)

All Python dependencies install automatically.


Per-Project Setup

cd your-project
reza init

This:

  1. Creates .reza/context.db
  2. Scans all source files and extracts purposes from docstrings/comments
  3. Detects your project's language and framework
  4. Installs a pre-commit git hook
  5. 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.