NotariumDocumentação
PT

Open Source

Uma base de conhecimento, para a sua IA já começar com contexto

Seus agentes, seu Markdown e seu editor — em um único contêiner.

Sobe com um único comando

O motor roda dentro do próprio processo: sem banco de dados externo, sem fila, sem serviço de busca à parte.

shell
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest

Espere alguns segundos e abra http://localhost:3000.

Um único volume /data guarda todo o estado: suas notas, o banco de metadados e os índices.

Um produto coeso, não uma colcha de retalhos de plugins.

Markdown como fonte da verdade

As notas são arquivos .md comuns. Índice, grafo e histórico de versões derivam deles: sem o Notarium, os arquivos continuam sendo notas completas, e importação e exportação não perdem nada pelo caminho.

Editor web, não visualizador

Uma árvore que aguenta dezenas de milhares de notas, um editor baseado em CodeMirror, wiki-links, um grafo de conhecimento. Trabalho diário de verdade no navegador, de qualquer dispositivo.

Uma base para você e o agente

Endpoint MCP embutido: o agente escreve na sua base pelo mesmo caminho e com as mesmas permissões que você. Espaços e projetos delimitam esse trabalho — o agente assume o projeto de que precisa, não a base inteira.

Self-host em um contêiner

Um contêiner no lugar de uma pilha de serviços. Autenticação, espaços e busca ficam lá dentro; para fora, só uma porta.

Busca no núcleo, sem paywall

A busca de texto completo funciona sempre, a busca semântica você liga se quiser, e os resultados se fundem por RRF. Não é recurso premium nem assinatura à parte.

Histórico e proveniência

Toda edição entra no registro de revisões da nota, assinada por quem a fez: dá para ver o que foi editado por uma pessoa e o que foi editado por um agente. Qualquer versão pode ser comparada com a atual e restaurada.

Seu agente não começa do zero

Uma pasta de arquivos Markdown dá texto ao agente. Uma base de conhecimento dá estrutura: links, grafo e busca. Com isso ele recupera o contexto de que precisa, em vez de despejar tudo na janela.

Busca, não paredão de texto

Busca de texto completo e semântica em toda a base — na janela de contexto entra o que importa, não tudo.

Links, não lista plana

Wiki-links e o grafo entregam ao agente a estrutura do que ele lê: a partir de qualquer nota, com o que ela se conecta.

Ferramentas de intenção

Ferramentas de escopo estreito, orientadas a intenção, em vez de CRUD nu e cru. O gateway é uma fronteira de confiança, não um wrapper de conveniência.

O agente entra em contexto mais rápido quando o caminho até ele está escrito no arquivo de regras: aí a sessão já começa pelo projeto, e não tateando à procura dele.

CLAUDE.md · AGENTS.md · .cursor/rules
## Notarium- No início da sessão, chame start_session(project: "acme/website")- Leia as convenções do projeto com get_note("nHk2VqA0es")- Antes de escrever, procure notas relacionadas usando search("<tema>", project: "acme/website")

O que a primeira chamada já traz

  • seu perfil e as notas fixadas para este projeto
  • o índice do projeto e o vocabulário de categorias já em uso
  • o que mudou desde a última visita
Regras do agente →

Os limites, sem rodeios

Aqui estão duas coisas diferentes: o que o Notarium decidiu não ter, e o que apenas ainda não existe.

Decidido assim, e assim fica

Sem criptografia de ponta a ponta

Busca, semântica, histórico e agentes precisam ler o seu texto. A privacidade aqui se apoia em você ser dono dos arquivos e hospedá-los, não em E2EE. Se você precisa de armazenamento zero-knowledge, o Notarium não serve.

Não é editor de blocos

A unidade de dados é a nota em arquivo, não um bloco dentro do banco de outra pessoa. Esse é o preço da portabilidade, e o pagamos conscientemente.

O que ainda não existe

São direções de desenvolvimento, não falhas — áreas deixadas de propósito para depois:

  • edição colaborativa em tempo real
  • plugins e extensões
  • um editor WYSIWYG completo
  • aplicativos desktop e mobile
  • trabalhar com os dados offline
  • controle de acesso por nota
  • grafo entre espaços
  • adaptadores de armazenamento externo

Hoje o Notarium está na 0.1.0, um beta aberto.

Licença

AGPL-3.0. Todos os recursos são abertos e gratuitos — inclusive o uso dentro de uma empresa como ferramenta interna. Uma licença comercial à parte só é necessária para quem monetiza o próprio Notarium como produto.

Leia a licença na íntegra →

Suba a sua instância

Um comando sobe a base localmente. Depois: conecte o seu agente e traga as suas notas.