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ón | Qué obtienes | Índices vectoriales / full-text |
|---|---|---|
Wheel de Python — pip install namidb | El 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 — namidb | Consultas puntuales, inspección de planes, backup / restore, ingesta de vaults de Markdown. | No incluidos en el archivo del release |
Servidor MCP — namidb-mcp | Un servidor Model Context Protocol de solo lectura sobre stdio para agentes de IA. | No incluidos en el archivo del release |
| Crates de Rust — dependencia git | Los crates de almacenamiento y consultas embebidos directamente. API de bajo nivel, inestable. | Features de Cargo opcionales |
Por dónde empezar
- Instalación — pip, Docker, binarios del release o desde el código fuente.
- Tu primera consulta — un grafo en memoria en menos de un minuto, sin credenciales.
- Servidor HTTP — ejecuta
namidb-serverpara otros procesos y lenguajes. - Cypher soportado — exactamente lo que acepta el motor de consultas.
- Referencia de configuración — cada flag y variable de entorno con su valor por defecto.
Qué incluye
- Grafo de propiedades con Cypher / GQL.
MATCH,OPTIONAL MATCH,MERGE,FOREACH, subconsultasCALL { … },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.