Inicio rápido
Notarium es una base de conocimiento autoalojada, construida como archivos Markdown planos en tu propio disco, sobre la que una persona y un agente de IA trabajan de igual a igual. Sin nube, sin formato propietario: las notas viven en carpetas, y git puede ser la fuente de verdad.
Esta sección es el camino más corto de cero a una instancia en marcha: despliega Notarium en un solo contenedor, crea tu primera nota en el editor web y conecta tu agente por MCP. Todo el recorrido lleva unos cinco minutos.
Solo Docker (o Docker Desktop) y un puerto libre. Todo lo demás —el editor web, el motor y el endpoint MCP para agentes— ya está dentro de la imagen. No hace falta instalar Node, una base de datos ni un índice vectorial por separado.
Cómo funciona
La misma base de conocimiento está abierta a dos lectores a la vez. La persona trabaja a través del editor web; el agente, a través del endpoint MCP; ambos ven el mismo grafo de notas, y en disco no es más que un árbol de archivos .md.
flowchart LR
human([Persona]) -->|editor web| core
agent([Agente de IA]) -->|MCP · start_session| core
core[Motor de Notarium] --> files[(Archivos Markdown<br/>en disco)]
files -.->|git = fuente de verdad| git[(Repositorio)]
El principio clave es file-first: una nota es un archivo, no una fila en la base de datos de otro. No hace falta exportar, porque en realidad nunca estás "dentro": los datos son siempre tuyos y siempre están en disco.
Levanta una instancia
La vía más rápida es ejecutar la imagen precompilada. Es autocontenida: levanta el motor, la interfaz web y el endpoint MCP de una sola vez.
# Descarga la imagen y arranca el contenedor
docker run -d --name notarium \
-p 3000:3000 \
-v notarium-data:/data \
docouno/notarium:latest
Un único volumen /data guarda todo el estado: la base de datos de metadatos, los índices, tus notas y los artefactos de exportación. No hay nada más que configurar: el puerto 3000 y la ruta de datos /data ya vienen fijados en la imagen. El puerto a la izquierda de 3000 puede cambiarse por cualquiera que esté libre.
Abre http://localhost:3000: te recibirá la pantalla de configuración del primer arranque. Crea al propietario de la instancia (la primera cuenta) y un espacio inicial (personal). Después de eso, ya estás en el editor.
Puedes cambiar el puerto 3000 editando el número de la izquierda en -p <el-tuyo>:3000. La imagen docouno/notarium es pública: esta es la vía de instalación principal (los detalles y la compilación desde el código fuente están en la página de Instalación). El volumen /data sobrevive cuando recreas el contenedor, pero cuida el volumen en sí: tus datos se van con él.
Lo que ocurre bajo el capó en el primer arranque:
- el motor arranca y sirve la interfaz web en el puerto que indicaste;
- dentro del volumen
/datase inicializa el árbol de tus espacios; - la pantalla de configuración crea al propietario, la cuenta a la que pertenece la instancia.
Siguientes pasos
La instancia ya está en marcha; a continuación vienen tres pasos breves. Cada uno se cubre en su propia página:
| Paso | Página | Qué obtendrás |
|---|---|---|
| 1 | Instalación y arranque | Un recorrido por docker / make up, los volúmenes y la pantalla de configuración |
| 2 | Tu primera nota | El árbol de archivos, el editor web, el guardado en .md |
| 3 | Conecta un agente | Un token, el endpoint POST /mcp, la llamada a start_session |
¿Prefieres captar primero el modelo completo? Echa un vistazo a la sección Conceptos: espacios y proyectos, tipos de nota, el grafo de conocimiento y el modelo de acceso para personas y agentes.