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 tests | Wheel de Python |
| Ejecutar un servidor al que otros procesos se conecten por HTTP o Bolt | Imagen Docker o binario del servidor |
| Ejecutar consultas puntuales, backups e importaciones de vaults desde una shell | CLI namidb |
| Dar a un agente de IA acceso de lectura a un grafo | namidb-mcp |
| Embeber el motor en un programa Rust | Crates de Rust |
Python
pip install namidb- Python 3.9 o superior.
pyarrow >= 14se instala como dependencia. - Extras opcionales para DataFrames:
pip install 'namidb[pandas]'(pandas ≥ 2.0) ypip 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 INDEXyCREATE FULLTEXT INDEXfuncionan sin configuración adicional.
Verifica la instalación:
python -c "import namidb; print(namidb.__version__)"# 3.3.0Siguiente: 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.
| Registro | Imagen |
|---|---|
| Docker Hub | namidb/namidb-server |
| GitHub Container Registry | ghcr.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:
docker pull namidb/namidb-server:3.3.0Ejecú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:
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"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/namidbya existe y pertenece a ese usuario, así que un volumen con nombre nuevo montado ahí funciona directamente. Un bind mount requiere primerochown -R 65532:65532 <dir>en el host. NAMIDB_LISTEN=0.0.0.0:8080,NAMIDB_SPOOL_DIR=/var/tmp/namidb-spool,RUST_LOG=infoy arenas acotadas del allocator de glibc (MALLOC_ARENA_MAX=2).- Un
HEALTHCHECKintegrado que consulta/v0/livez. RespetaNAMIDB_LISTENy cambia a HTTPS cuando se defineNAMIDB_TLS_CERToNAMIDB_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:
| Archivo | Contiene | Compilado con |
|---|---|---|
namidb-server-v3.3.0-<target> | namidb-server | vector-index, text-index |
namidb-v3.3.0-<target> | namidb (CLI) y namidb-mcp | sin 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.
TARGET=x86_64-unknown-linux-gnu # or aarch64-unknown-linux-gnu, aarch64-apple-darwinBASE=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.0El archivo de la CLI funciona igual y extrae namidb y namidb-mcp:
./namidb --version # namidb 3.3.0./namidb-mcp --version # namidb-mcp 3.3.0Desde el código fuente
Requiere Rust 1.85 o superior.
git clone https://github.com/namidb/namidbcd namidbgit checkout v3.3.0# 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,pdpUn cargo install simple sin features produce un binario más pequeño que
rechaza CREATE VECTOR INDEX / CREATE FULLTEXT INDEX con HTTP 400.
cargo install --locked --path crates/namidb-clicargo install --locked --path crates/namidb-mcppip install maturincd crates/namidb-pymaturin develop --releasedocker build -t namidb/namidb-server:3.3.0-local -f crates/namidb-server/Dockerfile .| Feature del servidor | Habilita |
|---|---|
vector-index | CREATE VECTOR INDEX, DROP VECTOR INDEX y búsqueda vectorial con índice |
text-index | CREATE FULLTEXT INDEX, DROP INDEX y BM25 con índice |
jwt | Flags --jwt-*: validación de bearer OIDC / JWT contra un JWKS |
pdp | --pdp-url: un policy decision point externo al estilo de OPA |