Configuration

Navegador has minimal required configuration. The only thing you typically need to set is where the graph database lives.

---

Database path

SQLite (default)

By default navegador writes a navegador.db file in the current working directory. Override with the --db flag or the NAVEGADOR_DB environment variable:

# flag (takes precedence)
navegador ingest ./repo --db ~/.navegador/myproject.db

# environment variable
export NAVEGADOR_DB=~/.navegador/myproject.db
navegador ingest ./repo

The .navegador/ directory convention keeps the database alongside your project:

my-project/
  .navegador/
    navegador.db    ← graph database
  src/
  ...

Add .navegador/ to .gitignore — the database is a build artifact, not source.

Redis (production)

For team or CI environments, point NAVEGADOR_DB at a Redis instance running FalkorDB:

export NAVEGADOR_DB=redis://localhost:6379

With authentication:

export NAVEGADOR_DB=redis://:[email protected]:6379

Install the Redis extra if you haven't already:

pip install "navegador[redis]"

---

SQLite vs Redis: when to use which

| SQLite (falkordblite) | Redis (FalkorDB)
---|---|---
Setup | Zero config | Requires a Redis server
Use case | Local dev, single developer | Team, CI, shared context
Persistence | Local file | Redis persistence config
Performance | Fast for single-user workloads | Scales to large codebases
Extra required | None (included) | navegador[redis]

Both backends implement the same GraphStore interface. You can migrate by re-ingesting against the new backend.

---

GitHub token

Required for navegador wiki ingest --repo owner/repo to access private wikis or to avoid rate limits on public repos.

export GITHUB_TOKEN=ghp_...
navegador wiki ingest --repo myorg/myrepo

For public repos, wiki ingestion works without a token but will hit GitHub's unauthenticated rate limit (60 req/hr).

---

Environment variable reference

Variable	Default	Description
NAVEGADOR_DB	./navegador.db	Path to SQLite file or redis:// URL
GITHUB_TOKEN	—	GitHub personal access token for wiki ingestion

---

Project-local config

Drop a .navegador/config.toml in your project root for project-specific defaults (optional):

[database]
path = ".navegador/navegador.db"

[ingest]
exclude = ["node_modules", "dist", ".venv", "migrations"]

Note

.navegador/config.toml support is planned. Check navegador --version to confirm it is available in your installed version.

Z 199