Installation

Requirements

• Python 3.12 or later — required by falkordblite, the embedded SQLite backend
• pip 23+

Install

pip install navegador

This installs the core package with the SQLite backend (falkordblite) included. No external services are required for local use.

Optional extras

The default. falkordblite is bundled and requires no configuration. This is what pip install navegador already gives you.

pip install "navegador[sqlite]"   # explicit, same as above

Note

falkordblite requires Python 3.12+. Its embedded SQLite graph engine uses features not available in earlier Python versions.

For production deployments backed by a Redis instance running FalkorDB.

pip install "navegador[redis]"

Then point navegador at your Redis instance:

export NAVEGADOR_DB=redis://localhost:6379
navegador ingest ./repo

See Configuration for full Redis setup details.

Verify

navegador --version

Expected output:

navegador, version 0.x.y

Development install

git clone https://github.com/ConflictHQ/navegador
cd navegador
pip install -e ".[sqlite,redis]"

Upgrading

pip install --upgrade navegador

After upgrading, re-ingest any existing repos to pick up new parser features or schema changes:

navegador ingest ./repo --clear

Z