Documentación de NamiDB

NamiDB es un motor de base de datos en grafo. Su estado — manifest, WAL, SSTs, schema — vive como objetos planos en un bucket compatible con S3. El motor viene en tres formas (librería embebida, daemon HTTP, cloud manejado); las tres hablan el mismo Cypher y escriben al mismo layout de bucket.

Estos docs cubren el motor de punta a punta. Si nunca usaste NamiDB, el inicio rápido de 30 segundos es la prueba más rápida; el walkthrough de S3 muestra el caso de uso principal.

Mapa de la documentación

Empezar

Qué es NamiDB, las tres formas de despliegue, cómo instalar cada cliente, y los dos caminos de inicio rápido.

• Qué es NamiDB
• Inicio rápido en 30 segundos
• Tu grafo en S3
• Elegir un despliegue
• Instalar

Conceptos

Los modelos mentales detrás del motor — por qué el object storage como fuente de verdad funciona, qué es un snapshot, cómo se hace cumplir el single-writer-per-namespace, dónde viven los caches.

• El bucket es la base de datos
• Tres despliegues, un motor
• Namespaces y multi-tenancy
• Snapshots y epoch fencing
• LSM sobre object storage
• Caches

Referencia de Cypher

El subset exacto de GQL (ISO/IEC 39075:2024) + openCypher 9 que NamiDB parsea, planifica y ejecuta hoy. Incluye las 12 queries en scope de LDBC SNB Interactive.

• Subset soportado
• Queries de lectura
• Queries de escritura
• Funciones y operadores
• LDBC SNB IC01–IC12

Referencia de SDK

Un motor, cuatro superficies. Mismo Cypher en todas.

• Python — pip install namidb
• Rust (embebido) — cargo add namidb
• CLI — namidb parse / explain / run
• API HTTP — endpoints REST de namidb-server

Operación

Variables de entorno, la gramática de URIs, los seis backends de almacenamiento, la receta de self-host con Docker Compose, observabilidad, backups y perillas de tuning.

• Configuración · Gramática de URIs
• Backends de almacenamiento: AWS S3 · R2 · GCS · Azure · MinIO/Tigris/LocalStack · Local
• Self-host con Docker Compose
• Observabilidad · Backup y restore · Tuning

Cloud

SaaS multi-tenant manejado en namidb.com, scale-to-zero por namespace, beta cerrada.

• Qué es NamiDB Cloud
• Solicitar acceso
• Cloud vs self-hosted

Internals (RFCs)

18 RFCs de diseño que cubren el storage engine, formato SST, motor de queries, optimizador basado en costos, factorización, y caches. La fuente canónica de “por qué el motor se ve como se ve”.

• Índice de RFCs
• Storage engine: RFC-001 · RFC-002 · RFC-003
• Lenguaje de queries: RFC-004 · RFC-008 · RFC-009
• Optimizador: RFC-010 → 016
• Ejecutor y caches: RFC-017 · RFC-018 · RFC-019 · RFC-020

Comunidad

Cómo participar del desarrollo de NamiDB, el proceso de RFCs, reporte de vulnerabilidades, términos de la licencia.

• Contribuir
• Proceso de RFCs
• Seguridad
• Licencia (BSL 1.1)

Changelog

Todos los cambios notables a lo largo del motor, las bindings de Python, el servidor y el CLI.

Puntos de entrada comunes

• Quiero escribir Cypher ahora mismo → Inicio rápido de 30 s
• Quiero usar mi propio bucket de S3 → Tu grafo en S3
• Quiero un endpoint REST para llamar desde mi app → API HTTP + Receta de self-host
• Quiero saber qué Cypher funciona → Subset soportado
• Quiero leer cómo funciona el storage engine → RFC-001 → RFC-002
• Quiero migrar desde Kùzu / Neo4j → Referencia de Cypher y abre un issue si falta algo
• Quiero el producto manejado → NamiDB Cloud

Información del proyecto

Recurso	Dónde
Repo del motor	github.com/namidb/namidb
Paquete PyPI	pypi.org/project/namidb
Issues y RFCs	github.com/namidb/namidb/issues
Seguridad	security@namidb.com
General	hello@namidb.com
Sitio web	namidb.com
Licencia	BSL 1.1 → Apache 2.0 en 3 años