Pular para o conteúdo
Engram Docs

Primeiros passos

O Engram é uma camada de sincronização em tempo real, busca semântica e acesso por IA para as suas notas em Markdown. As notas continuam sendo suas, como arquivos .md simples. Use o Engram junto com o Obsidian para a melhor experiência de captura, ou trabalhe só pelo app web do Engram e por assistentes de IA como o Claude. Seus cofres sincronizam entre todos eles, e um endpoint MCP permite que ferramentas de IA leiam e atualizem suas notas com a sua permissão.

Como as peças se encaixam

Seção intitulada “Como as peças se encaixam”
┌──────────────────────┐         ┌──────────────────────┐
│  Obsidian            │ ◄────►  │  Engram backend      │
│  + Engram plugin     │  sync   │  (Elixir / Phoenix)  │
└──────────────────────┘         └──────────┬───────────┘
                                            │
   ┌────────────────────────────────────────┤
   │                                        │
   ▼                                        ▼
┌──────────────────┐               ┌──────────────────┐
│  Web app         │               │  AI assistants   │
│  (browser)       │               │  via MCP         │
└──────────────────┘               └──────────────────┘

Três interfaces sobre os mesmos dados do cofre:

  • O plugin do Obsidian é a principal superfície de captura. As notas são escritas no Obsidian e sincronizam com o backend em tempo real.
  • O app web em app.engram.page. Navegue, busque e edite seu cofre de qualquer navegador. Ele renderiza wikilinks, embeds, KaTeX e Mermaid do mesmo jeito que o Obsidian.
  • O endpoint MCP conecta Claude, Cursor, ChatGPT e outros assistentes de IA que conseguem conversar com o seu cofre. Suas notas ficam acessíveis como chamadas de ferramenta.

Nuvem ou hospedagem própria

Seção intitulada “Nuvem ou hospedagem própria”

O Engram roda como um serviço hospedado ou na sua própria infraestrutura. Escolha de que lado dessa linha você quer ficar:

NuvemHospedagem própria
Ondeapp.engram.pageSeu servidor (Docker)
OperaçãoGerenciadaSua
Modelo de embeddingsVoyage AI (hospedado)Ollama (local) ou o seu próprio
ArmazenamentoAWS S3MinIO / seu S3
CobrançaAssinatura via PaddleGrátis, você paga só o seu hardware
LicençaHospedado sob os nossos TermosPolyForm Small Business 1.0.0
Ideal paraQuem só quer que funcioneSoberania, cofres grandes, uso em laboratório

O plugin é o mesmo dos dois lados; basta apontá-lo para outro endereço de backend. O conteúdo do cofre vive no Obsidian de qualquer forma, então trocar de lado é só reapontar o plugin e reenviar o cofre. Ferramentas automáticas de exportação/importação entre nuvem e hospedagem própria estão no roadmap; hoje o caminho é manual (envie do Obsidian para o lado para o qual você está indo).

Início rápido na nuvem

Seção intitulada “Início rápido na nuvem”

Cinco passos, cerca de cinco minutos:

  1. Crie sua conta em app.engram.page e conclua o assistente de integração (aceite os Termos, escolha um plano).
  2. Instale o plugin Engram Vault Sync no Obsidian. Abra Settings → Community plugins → Browse e procure por Engram Vault Sync, ou abra a página do plugin direto em community.obsidian.md/plugins/engram-vault-sync.
  3. Entre com o plugin na sua conta do Engram. O plugin abre uma janela OAuth; aprove.
  4. Escolha um cofre para sincronizar. O Engram envia o instantâneo inicial e depois o mantém ao vivo.
  5. Busque e use. Experimente a busca semântica no app web ou na paleta de comandos. As notas ficam acessíveis pelo Obsidian, pelo app web e (depois de configurado) por clientes MCP.

Início rápido da hospedagem própria

Seção intitulada “Início rápido da hospedagem própria”

Se você quer rodar o Engram no seu próprio servidor, vá para Hospedagem própria. Em resumo: baixe a stack do Docker Compose, defina algumas variáveis de ambiente e rode docker compose up. O guia completo cobre configuração de ambiente, criptografia, backups e caminhos de atualização.

Conecte um assistente de IA

Seção intitulada “Conecte um assistente de IA”

Com o cofre sincronizando, conecte-o ao Claude Desktop (ou a qualquer cliente MCP) e suas notas passam a ser ferramentas pesquisáveis e graváveis. Veja Integrações de IA para a configuração de cada cliente, ou IA / MCP para o contexto no nível do protocolo.

Próximos passos

Seção intitulada “Próximos passos”