Início rápido
O Notarium é uma base de conhecimento auto-hospedada (self-host) construída como arquivos Markdown simples no seu próprio disco — uma base em que uma pessoa e um agente de IA trabalham de igual para igual. Sem nuvem, sem formato proprietário: as notas ficam em pastas, e o git pode ser a fonte da verdade.
Esta seção é o caminho mais curto do zero até uma instância no ar: subir o Notarium em um único contêiner, criar sua primeira nota no editor web e conectar seu agente via MCP. Tudo isso leva cerca de cinco minutos.
Só do Docker (ou Docker Desktop) e de uma porta livre. Todo o resto — o editor web, o motor e o endpoint MCP para agentes — já vem dentro da imagem. Não é preciso instalar Node, um banco de dados nem um índice vetorial à parte.
Como funciona
A mesma base de conhecimento fica aberta a dois leitores ao mesmo tempo. A pessoa trabalha pelo editor web, o agente pelo endpoint MCP; os dois enxergam o mesmo grafo de notas, e no disco é apenas uma árvore de arquivos .md.
flowchart LR
human([Pessoa]) -->|editor web| core
agent([Agente de IA]) -->|MCP · start_session| core
core[Motor do Notarium] --> files[(Arquivos Markdown<br/>no disco)]
files -.->|git = fonte da verdade| git[(Repositório)]
O princípio-chave é o file-first: uma nota é um arquivo, não uma linha no banco de dados de outra pessoa. Não é preciso exportar, porque você nunca está de fato "lá dentro" — os dados são sempre seus e sempre ficam no disco.
Suba uma instância
O jeito mais rápido é rodar a imagem pré-construída. Ela é autossuficiente: sobe o motor, a interface web e o endpoint MCP de uma só vez.
# Baixe a imagem e suba o contêiner
docker run -d --name notarium \
-p 3000:3000 \
-v notarium-data:/data \
docouno/notarium:latest
Um único volume /data guarda todo o estado: o banco de metadados, os índices, suas notas e os artefatos de exportação. Não há mais nada a configurar — a porta 3000 e o caminho de dados /data já vêm definidos na imagem. A porta à esquerda de 3000 pode ser trocada por qualquer outra livre.
Abra http://localhost:3000 — você será recebido pela tela de configuração inicial. Ela cria o dono da instância (a primeira conta) e um espaço inicial (pessoal). Depois disso, você já está no editor.
Você pode mudar a porta 3000 alterando o número à esquerda em -p <a-sua>:3000. A imagem docouno/notarium é pública — este é o caminho principal de instalação (detalhes e a compilação a partir do código-fonte estão na página Instalação). O volume /data sobrevive à recriação do contêiner — mas cuide do volume em si: junto com ele vão embora os seus dados.
O que acontece nos bastidores no primeiro início:
- o motor sobe e serve a interface web na porta que você indicou;
- a árvore dos seus espaços é inicializada dentro do volume
/data; - a tela de configuração cria o dono — a conta a quem a instância pertence.
Próximos passos
A instância está no ar — a seguir vêm três passos curtos. Cada um é detalhado em sua própria página:
| Passo | Página | O que você vai obter |
|---|---|---|
| 1 | Instalação e início | Um passo a passo de docker / make up, volumes e da tela de configuração |
| 2 | Sua primeira nota | A árvore de arquivos, o editor web, salvar em .md |
| 3 | Conectar um agente | Um token, o endpoint POST /mcp, chamar start_session |
Quer entender o modelo inteiro primeiro? Dê uma olhada na seção Conceitos: espaços e projetos, tipos de nota, o grafo de conhecimento e o modelo de acesso para pessoas e agentes.