Saltearse al contenido

NamiDB self-hosted

NamiDB es una base de datos de grafos de propiedades que guarda sus datos en almacenamiento de objetos. Tú escribes Cypher; el motor organiza nodos y relaciones como archivos columnares inmutables en un bucket (o en una carpeta local), y ese bucket es la única fuente de verdad. No hay un servicio de metadatos aparte ni un clúster de consenso: los commits se coordinan con escrituras condicionales sobre el propio bucket.

Estas páginas documentan la versión 3.3.0 del motor (2026-11-03). Cada comando, consulta y respuesta que aparece aquí se ejecutó contra los artefactos de la versión 3.2.0, y los que cambian en versiones posteriores (las cadenas de versión, el presupuesto de memoria por consulta, los puntos de restauración, los timeouts y la cancelación) otra vez contra 3.2.1 y 3.3.0.

Formas de ejecutarlo

El mismo motor se distribuye en varias presentaciones. Elige el límite que prefieras.

PresentaciónQué obtienesÍndices vectoriales / full-text
Wheel de Python — pip install namidbEl motor dentro de tu proceso de Python. APIs síncrona y asyncio, resultados en Arrow / pandas / polars.Incluidos
Servidor — namidb-server (imagen Docker o binario del release)API HTTP JSON y un listener Bolt opcional para drivers de Neo4j. Autenticación, TLS, métricas, modo multi-tenant, endpoints de backup / restore.Incluidos
CLI — namidbConsultas puntuales, inspección de planes, backup / restore, ingesta de vaults de Markdown.No incluidos en el archivo del release
Servidor MCP — namidb-mcpUn servidor Model Context Protocol de solo lectura sobre stdio para agentes de IA.No incluidos en el archivo del release
Crates de Rust — dependencia gitLos crates de almacenamiento y consultas embebidos directamente. API de bajo nivel, inestable.Features de Cargo opcionales

Por dónde empezar

Qué incluye

  • Grafo de propiedades con Cypher / GQL. MATCH, OPTIONAL MATCH, MERGE, FOREACH, subconsultas CALL { … }, EXISTS { … }, disyunción de labels (n:A|B), caminos de longitud variable (*, *1..$n), shortestPath, agregaciones, list comprehensions y más. Consulta Cypher.
  • Esquema cuando lo necesites. Restricciones de unicidad (simples y compuestas), índices de igualdad (simples y compuestos), SHOW CONSTRAINTS / SHOW INDEXES. Consulta Esquema.
  • Búsqueda vectorial, full-text e híbrida. KNN por coseno / producto punto / distancia euclidiana, un índice ANN persistente, BM25 con frases y prefijos, y Reciprocal Rank Fusion. Consulta Búsqueda.
  • Algoritmos de grafos. PageRank, componentes conexas, Louvain, label propagation, betweenness, conteo de triángulos, caminos más cortos y FastRP. Consulta Algoritmos.
  • Autenticación de verdad. Tokens estáticos con roles y alcances por namespace, OIDC/JWT opcional y un hook de políticas externo opcional. Consulta Autenticación.
  • Operación integrada. Backups en línea, restore, compactación, métricas de Prometheus, un log de consultas lentas y una lista de consultas en curso con cancelación. Consulta Operación.

Conceptos clave

  • Namespace. Un grafo independiente: su propio manifest, write-ahead log, archivos de datos y writer. Los nombres cumplen [a-z0-9][a-z0-9_-]{0,62}. Un URI de almacenamiento indica el namespace con ?ns=<name>.
  • Un writer por namespace. Cualquier cantidad de lectores, un solo writer. Un proceso que abre un namespace para escritura reclama un epoch y bloquea (fencing) al writer anterior. Consulta Modo multi-tenant para ver cómo funciona esto con muchos namespaces.
  • Durable al retornar. Una escritura Cypher queda confirmada (append al WAL más una escritura condicional del puntero del manifest) antes de que la llamada retorne. El flush convierte la tabla en memoria en archivos de datos inmutables; la compactación los fusiona. Consulta Mantenimiento.
  • Requisito de almacenamiento. El bucket debe respetar PUT-if-absent (If-None-Match: *). AWS S3, Google Cloud Storage, Azure Blob Storage, Cloudflare R2, Tigris y las versiones actuales de MinIO lo hacen. Consulta Object stores.

Licencia

El motor es source-available bajo la Business Source License 1.1 (BSL 1.1). Puedes copiarlo, modificarlo y usarlo para fines que no sean de producción, y el Additional Use Grant permite el uso en producción como parte de tu propio producto o servicio, siempre que ese producto no sea en sí mismo un producto de base de datos de grafos y que no ofrezcas NamiDB a terceros como servicio alojado o gestionado. Cada versión pasa a la Apache License 2.0 el 18 de mayo de 2029, o en el cuarto aniversario de la primera publicación de esa versión si esa fecha es anterior. El archivo LICENSE es el texto de referencia. Para usos fuera del grant, NamiDB, Inc. ofrece una licencia comercial en info@namidb.com.

Versionado

Los binarios publicados de la CLI y del servidor, las superficies HTTP / Bolt / Cypher, el paquete de PyPI, las imágenes de contenedor y los formatos en disco siguen Semantic Versioning; los cambios incompatibles suben la versión mayor. Los crates del workspace de Rust no se publican en crates.io y sus elementos pub todavía no son una API estable. Consulta el changelog y Actualizaciones.