Instalar

NamiDB se distribuye en cuatro sabores, todos sobre el mismo core en Rust.

Python

Wheels pre-construidas (abi3) para Python ≥ 3.9 en Linux (x86_64 + aarch64), macOS (arm64) y Windows (x86_64). Intel macOS cae a sdist.

pip install namidb                # core
pip install 'namidb[pandas]'      # + interop con DataFrames
pip install 'namidb[polars]'      # + interop con Polars

pyarrow >= 14 es una dependencia transitiva obligatoria.

Desde el código fuente

pip install maturin
git clone https://github.com/namidb/namidb.git
cd namidb/crates/namidb-py
maturin develop --release --extras test

→ Referencia completa del SDK de Python

Rust (embebido)

Agrega el crate paraguas a tu Cargo.toml:

[dependencies]
namidb = "0.3"
tokio = { version = "1", features = ["full"] }

El MSRV es Rust 1.85. El workspace expone un crate de fachada estable para que el código aguas abajo necesite una sola línea.

→ Referencia completa del SDK de Rust

CLI

Desde el código fuente (instalación de un paso):

git clone https://github.com/namidb/namidb.git
cd namidb
cargo install --path crates/namidb-cli

namidb run "CREATE (a:Person {name: 'Alice'})"
namidb run --store s3://my-bucket?ns=prod \
  "MATCH (p:Person) RETURN count(*) AS n"
namidb explain --verbose \
  "MATCH (a:Person)-[:KNOWS]->(b) RETURN b ORDER BY b.id LIMIT 20"

→ Referencia completa del CLI

Servidor HTTP (namidb-server)

Cargo

cargo install --path crates/namidb-server

Docker

docker build -t namidb-server:0.3 \
  -f crates/namidb-server/Dockerfile .

Para correrlo:

namidb-server \
  --store 's3://my-bucket?ns=prod&region=us-east-1' \
  --listen 0.0.0.0:8080 \
  --auth-token "$NAMIDB_AUTH_TOKEN" \
  --flush-interval 30s

Cada flag también es una variable de entorno: NAMIDB_STORE, NAMIDB_LISTEN, NAMIDB_AUTH_TOKEN, NAMIDB_FLUSH_INTERVAL.

Sin token, no hay producción

Si --auth-token no está definido, el servidor arranca en modo no autenticado y muestra un warning ruidoso. No expongas ese puerto al internet público.

→ Referencia completa de la API HTTP · → Self-host con Docker Compose

Verificar la instalación

Python

import namidb as tg
client = tg.Client("memory://test")
print(client.cypher("RETURN 1 AS n").rows())
# [{'n': 1}]

CLI

namidb run "RETURN 1 AS n"

HTTP

namidb-server --store memory://test --listen 127.0.0.1:8080 &
curl -s http://127.0.0.1:8080/v0/health | jq .

Plataformas soportadas

Superficie	Linux x86_64	Linux aarch64	macOS arm64	macOS x86_64	Windows x86_64
Wheel de Python	✅	✅	✅	sdist	✅
Crate de Rust	✅	✅	✅	✅	✅
Binario namidb-server	✅	✅	✅	✅	✅
Imagen Docker	✅ (multi-arch)	✅ (multi-arch)	—	—	—