Inicio rápido
Esta página te lleva de cero a una consulta funcionando contra NamiDB Cloud en pocos minutos. Si prefieres ejecutar el motor tú mismo, consulta Self-hosted.
1. Crea una cuenta y una organización
-
Ve a app.namidb.com/signup. Regístrate con tu nombre, tu email y una contraseña (de al menos 10 caracteres), o con GitHub o Google cuando estén disponibles.
-
Confirma tu dirección. El email trae un enlace y un código de 6 dígitos; cualquiera de los dos sirve, una sola vez, durante 15 minutos.
-
Ponle nombre a tu organización. La organización es tu espacio de trabajo: es dueña de las bases de datos, las API keys, los miembros y la facturación. También puedes elegir dónde vive su almacenamiento, o dejar el valor por defecto (el más cercano a ti).
Las organizaciones nuevas empiezan en el plan Free. No se cobra nada hasta que un owner elige un plan pago y completa el checkout. Consulta Facturación.
2. Crea una base de datos
En la consola, abre Databases → Create database y llámala movies. Los
nombres usan letras minúsculas, números, - y _, empiezan con una letra o un
número y tienen como máximo 63 caracteres.
La página de la base de datos se abre en su pestaña Connect, que muestra el endpoint HTTPS y la URI de Bolt con fragmentos listos para copiar. Una base de datos vacía también ofrece Load sample dataset en la pestaña Query: un pequeño grafo de películas para probar consultas.
3. Crea una API key
Abre API keys → Create key:
- Name: algo que diga dónde se usa, como
quickstart. - Access: Read & write para esta guía. Usa Read only para todo lo que solo lee.
- Databases: All databases, o solo
movies. - Expires: 90 días por defecto.
La key tiene la forma nmdb_live_… y se muestra una sola vez. Cópiala ahora
en una variable de entorno:
export NAMIDB_API_KEY=nmdb_live_…NamiDB guarda solo un hash con clave de ella. Si la pierdes, revócala y crea una nueva. Más detalles en API keys y tokens de gestión.
4. Ejecuta tu primera consulta
curl https://db.namidb.com/v1/movies/cypher \ -H "Authorization: Bearer $NAMIDB_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "CREATE (:Movie {title: $title, released: $year})", "params": {"title": "Heat", "year": 1995}}'
curl https://db.namidb.com/v1/movies/cypher \ -H "Authorization: Bearer $NAMIDB_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "MATCH (m:Movie) RETURN m.title AS title, m.released AS year"}'{"columns": ["title", "year"], "rows": [{"title": "Heat", "year": 1995}]}npm install @namidb/cloudimport { NamiDB } from '@namidb/cloud';
const db = new NamiDB(); // reads NAMIDB_API_KEY
await db.query('movies', 'CREATE (:Movie {title: $title, released: $year})', { title: 'Heat', year: 1995,});
const { rows } = await db.query<{ title: string; year: number }>( 'movies', 'MATCH (m:Movie) RETURN m.title AS title, m.released AS year',);console.log(rows); // [ { title: 'Heat', year: 1995 } ]Funciona en Node 18+, Deno, Bun y runtimes edge. Consulta la referencia del SDK de JavaScript.
pip install namidb-cloudfrom namidb_cloud import NamiDB
db = NamiDB() # reads NAMIDB_API_KEY
db.query("movies", "CREATE (:Movie {title: $title, released: $year})", {"title": "Heat", "year": 1995})
result = db.query("movies", "MATCH (m:Movie) RETURN m.title AS title, m.released AS year")for row in result: print(row["title"], row["year"]) # Heat 1995Python 3.9+. Incluye un cliente asyncio. Consulta la referencia del SDK de Python.
pip install neo4jimport osfrom neo4j import GraphDatabase
# Any username works: the API key is the password.auth = ("namidb", os.environ["NAMIDB_API_KEY"])with GraphDatabase.driver("neo4j+s://db.namidb.com:7687", auth=auth) as driver: driver.execute_query( "CREATE (:Movie {title: $title, released: $year})", title="Heat", year=1995, database_="movies", ) records, _, _ = driver.execute_query( "MATCH (m:Movie) RETURN m.title AS title, m.released AS year", database_="movies", ) print([r.data() for r in records])Los drivers de Java, Go, .NET y JavaScript funcionan igual: consulta Bolt y drivers de Neo4j.
La primera consulta después de un periodo sin actividad puede tardar un momento mientras la base de datos despierta. Los SDKs y los drivers lo esperan; consulta Escalado a cero.
5. Mírala en la consola
Abre la pestaña Query de la base de datos y ejecuta:
MATCH (m:Movie) RETURN mCambia el resultado a Graph para ver los nodos, o a Table y JSON para ver los valores crudos. La pestaña Metrics muestra las lecturas y escrituras a medida que ocurren, y Usage las muestra frente a la cuota de tu plan.
Próximos pasos
- Conceptos: organizaciones, roles, bases de datos, keys y planes.
- Importa datos desde CSV o JSON.
- Conecta un agente de IA por MCP.
- Automatiza con la API de gestión.
- Aprende el Cypher que soporta NamiDB.