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¶

[sqlite][redis][languages][iac][llm]all 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.

Additional tree-sitter grammars for Kotlin, C#, PHP, Ruby, Swift, C, and C++. The default install includes Python, TypeScript, JavaScript, Go, Rust, and Java.

pip install "navegador[languages]"

After installing, all 13 languages are parsed automatically by navegador ingest. No additional configuration is required.

Infrastructure-as-Code parsers for HCL/Terraform, Puppet, Bash/Shell, Ansible, and Chef.

pip install "navegador[iac]"

After installing, .tf, .hcl, .pp, .sh, .bash, and .zsh files are parsed automatically. Ansible YAML files are detected heuristically by directory structure. Chef cookbooks are enriched via the Chef enricher on top of the Ruby parser.

LLM provider integrations for Anthropic, OpenAI, and Ollama. Required for navegador ask, navegador docs, and navegador semantic-search.

pip install "navegador[llm]"

Configure the provider in .navegador/config.toml or via environment variables. See Configuration for details.

Install everything at once:

pip install "navegador[sqlite,redis,languages,iac,llm]"

Verify¶

navegador --version

Expected output:

navegador, version 0.8.0

Shell completions¶

Install shell completions for tab-completion of commands and flags:

navegador completions bash >> ~/.bashrc
navegador completions zsh  >> ~/.zshrc
navegador completions fish > ~/.config/fish/completions/navegador.fish

Python SDK¶

The Python SDK wraps all CLI functionality in a single Navegador class:

from navegador import Navegador

nav = Navegador(".navegador/navegador.db")
nav.ingest("./src")
bundle = nav.explain("AuthService")
print(bundle.to_markdown())

The SDK is included in the base install — no extra is required.

Development install¶

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

Upgrading¶

pip install --upgrade navegador

After upgrading, run schema migrations first, then re-ingest to pick up new parser features:

navegador migrate          # apply any schema changes from the new version
navegador ingest ./repo    # re-ingest with incremental updates (preferred)
navegador ingest ./repo --clear  # full rebuild if you prefer a clean slate

Navegador