Saltearse al contenido

Instalación

NamiDB se distribuye como wheel de Python, imagen de contenedor del servidor, binarios precompilados y código fuente. Todos son el mismo motor; instala el que coincida con la forma en que quieres ejecutarlo.

Quieres…Instala
Usar el grafo desde código Python, notebooks o testsWheel de Python
Ejecutar un servidor al que otros procesos se conecten por HTTP o BoltImagen Docker o binario del servidor
Ejecutar consultas puntuales, backups e importaciones de vaults desde una shellCLI namidb
Dar a un agente de IA acceso de lectura a un grafonamidb-mcp
Embeber el motor en un programa RustCrates de Rust

Python

Ventana de terminal
pip install namidb
  • Python 3.9 o superior. pyarrow >= 14 se instala como dependencia.
  • Extras opcionales para DataFrames: pip install 'namidb[pandas]' (pandas ≥ 2.0) y pip install 'namidb[polars]' (polars ≥ 0.20).
  • Hay wheels abi3 precompilados para Linux x86_64 y aarch64, macOS arm64 y x86_64, y Windows x86_64. Las demás plataformas compilan desde la distribución de código fuente, lo que requiere un toolchain de Rust.
  • Los wheels incluyen los índices vectoriales y full-text persistentes, así que CREATE VECTOR INDEX y CREATE FULLTEXT INDEX funcionan sin configuración adicional.

Verifica la instalación:

Ventana de terminal
python -c "import namidb; print(namidb.__version__)"
# 3.3.0

Siguiente: Embebido (Python) y la referencia de la API de Python.

Docker

La imagen oficial namidb-server es multi-arquitectura (linux/amd64 y linux/arm64) y está compilada con búsqueda vectorial y full-text habilitadas.

RegistroImagen
Docker Hubnamidb/namidb-server
GitHub Container Registryghcr.io/namidb/namidb-server

Cada release se etiqueta como X.Y.Z, X.Y, X y latest. Fija una versión exacta en producción:

Ventana de terminal
docker pull namidb/namidb-server:3.3.0

Ejecútala con un volumen con nombre para tener un almacenamiento local durable. El servidor se niega a arrancar sin una fuente de autenticación, así que pásale un token:

Ventana de terminal
export NAMIDB_AUTH_TOKEN="$(openssl rand -hex 32)"
docker run --rm -p 127.0.0.1:8080:8080 \
-v namidb-data:/var/lib/namidb \
-e NAMIDB_AUTH_TOKEN \
namidb/namidb-server:3.3.0 \
--store "file:///var/lib/namidb?ns=prod"
Ventana de terminal
curl -s localhost:8080/v0/health
# {"status":"ok","namespace":"prod","manifest_version":0,"epoch":0,"writer":"ok",...}

Lo que configura la imagen:

  • El proceso corre como usuario no root (uid/gid 65532). /var/lib/namidb ya existe y pertenece a ese usuario, así que un volumen con nombre nuevo montado ahí funciona directamente. Un bind mount requiere primero chown -R 65532:65532 <dir> en el host.
  • NAMIDB_LISTEN=0.0.0.0:8080, NAMIDB_SPOOL_DIR=/var/tmp/namidb-spool, RUST_LOG=info y arenas acotadas del allocator de glibc (MALLOC_ARENA_MAX=2).
  • Un HEALTHCHECK integrado que consulta /v0/livez. Respeta NAMIDB_LISTEN y cambia a HTTPS cuando se define NAMIDB_TLS_CERT o NAMIDB_TLS_KEY; si cambias la dirección de escucha o TLS con flags de línea de comandos, define los mismos valores como variables de entorno para que el healthcheck los vea.

Para un servidor respaldado por un bucket compatible con S3, consulta Docker + MinIO.

Binarios del release

Cada release de GitHub incluye archivos precompilados con checksums SHA-256:

ArchivoContieneCompilado con
namidb-server-v3.3.0-<target>namidb-servervector-index, text-index
namidb-v3.3.0-<target>namidb (CLI) y namidb-mcpsin features opcionales

Targets: x86_64-unknown-linux-gnu, aarch64-unknown-linux-gnu, aarch64-apple-darwin (.tar.gz) y x86_64-pc-windows-msvc (.zip). Los archivos de Linux se compilan en Ubuntu 22.04 y requieren glibc 2.35 o superior; en sistemas más antiguos usa la imagen de contenedor o compila desde el código fuente.

Ventana de terminal
TARGET=x86_64-unknown-linux-gnu # or aarch64-unknown-linux-gnu, aarch64-apple-darwin
BASE=https://github.com/namidb/namidb/releases/download/v3.3.0
curl -fsSLO "$BASE/namidb-server-v3.3.0-$TARGET.tar.gz"
curl -fsSLO "$BASE/namidb-server-v3.3.0-$TARGET.sha256"
sha256sum -c "namidb-server-v3.3.0-$TARGET.sha256"
tar xzf "namidb-server-v3.3.0-$TARGET.tar.gz"
./namidb-server --version
# namidb-server 3.3.0

El archivo de la CLI funciona igual y extrae namidb y namidb-mcp:

Ventana de terminal
./namidb --version # namidb 3.3.0
./namidb-mcp --version # namidb-mcp 3.3.0

Desde el código fuente

Requiere Rust 1.85 o superior.

Ventana de terminal
git clone https://github.com/namidb/namidb
cd namidb
git checkout v3.3.0
Ventana de terminal
# Same feature set as the official image and release binary:
cargo install --locked --path crates/namidb-server --features vector-index,text-index
# Add OIDC/JWT and the external policy hook:
cargo install --locked --path crates/namidb-server --features vector-index,text-index,jwt,pdp

Un cargo install simple sin features produce un binario más pequeño que rechaza CREATE VECTOR INDEX / CREATE FULLTEXT INDEX con HTTP 400.

Feature del servidorHabilita
vector-indexCREATE VECTOR INDEX, DROP VECTOR INDEX y búsqueda vectorial con índice
text-indexCREATE FULLTEXT INDEX, DROP INDEX y BM25 con índice
jwtFlags --jwt-*: validación de bearer OIDC / JWT contra un JWKS
pdp--pdp-url: un policy decision point externo al estilo de OPA

Siguientes pasos