Repolode
Enviar
basicmachines-co

basicmachines-co/basic-memory

Camada de memória local-first que permite a assistentes de IA, como Claude e Cursor, ler e gravar suas notas como arquivos Markdown simples via MCP.

Ver no GitHubSite
Estrelas
4,509
Forks
352
Issues abertas
76
Último commit
há 24 horas

O que é?

O Basic Memory oferece memória persistente para assistentes de IA. O conhecimento fica armazenado no seu disco em arquivos Markdown, nos quais cada nota é uma entidade com observações (fatos em categorias entre colchetes) e relações (wikilinks para outras notas). Você e seu cliente de IA podem ler, gravar e pesquisar os mesmos arquivos, e as edições feitas no Obsidian ou em um editor também ficam disponíveis para o assistente.

O projeto disponibiliza suas ferramentas pelo Model Context Protocol, então funciona com Claude Desktop, Claude Code, Codex CLI, Cursor, VS Code e qualquer outro cliente compatível com MCP. Por padrão, usa um índice local SQLite, com Postgres como backend alternativo. A busca combina pesquisa de texto completo e classificação semântica por vetores, e um reranker cross-encoder opcional pode refinar os resultados.

Também há uma versão hospedada na nuvem para sincronização entre dispositivos e backups, mas a instalação local usa a licença AGPL-3.0 e funciona sem nenhum servidor.

Recursos principais

  • 01Armazena conhecimento em arquivos Markdown simples, com wikilinks e frontmatter.
  • 02Funciona com qualquer cliente MCP, incluindo Claude, Codex, Cursor e VS Code.
  • 03Oferece busca por palavras-chave, semântica por vetores e híbrida nas notas.
  • 04Reranking opcional com cross-encoder para resultados de busca vetorial e híbrida.
  • 05Oferece uma CLI para gerenciamento de projetos, verificações de integridade, importações e acesso às ferramentas.
  • 06Funciona localmente com SQLite, com a opção de usar um backend Postgres.

Casos de uso

  • Manter decisões de arquitetura e contexto de projetos disponíveis entre sessões de conversa com IA.
  • Criar uma base de conhecimento pessoal que você e seu assistente de IA possam editar.
  • Importar conversas anteriores do Claude ou ChatGPT para notas pesquisáveis.
  • Usar o Obsidian como editor de notas que também são mantidas por um assistente de IA.

Início rápido

  1. 1

    Instale o Basic Memory com uv

    uv tool install basic-memory --prerelease=allow
  2. 2

    Adicione o servidor do Basic Memory à configuração do seu cliente de IA (exemplo para o Claude Desktop)

  3. 3

    Reinicie o cliente de IA e comece a usar

Antes de usar

  • A instalação local requer Python gerenciado pelo uv.
  • Licenciado sob AGPL-3.0, uma licença copyleft que exige o compartilhamento do código-fonte modificado quando oferecido como serviço de rede.
  • Depende de uma versão pré-lançamento do FastMCP; por isso, a flag --prerelease=allow é necessária, ou uma versão mais antiga será instalada.

Em coleções

Servidores MCP para Claude CodeFerramentas, skills e plugins para Claude CodeServidores MCPFerramentas de privacidade e local-firstAgentes pessoais de IA open sourceGeradores de sites estáticos e ferramentas de documentação

Tópicos

#ai#mcp#markdown#knowledge-management#local-first#llm#personal-agent#obsidian#claude#knowlege-graph

Perguntas frequentes

O que é basic-memory?
Camada de memória local-first que permite a assistentes de IA, como Claude e Cursor, ler e gravar suas notas como arquivos Markdown simples via MCP. O Basic Memory oferece memória persistente para assistentes de IA. O conhecimento fica armazenado no seu disco em arquivos Markdown, nos quais cada nota é uma entidade com observações (fatos em categorias entre colchetes) e relações (wikilinks para outras notas). Você e seu cliente de IA podem ler, gravar e pesquisar os mesmos arquivos, e as edições feitas no Obsidian ou em um editor também ficam disponíveis para o assistente.
basic-memory é gratuito? Qual é a licença?
basic-memory é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
basic-memory ainda é mantido?
Manutenção ativa. O último commit de basic-memory foi em 6 de nov. de 2026.
Para que posso usar basic-memory?
Manter decisões de arquitetura e contexto de projetos disponíveis entre sessões de conversa com IA. Criar uma base de conhecimento pessoal que você e seu assistente de IA possam editar. Importar conversas anteriores do Claude ou ChatGPT para notas pesquisáveis. Usar o Obsidian como editor de notas que também são mantidas por um assistente de IA.
Como instalar basic-memory?
Instale o Basic Memory com uv: uv tool install basic-memory --prerelease=allow Adicione o servidor do Basic Memory à configuração do seu cliente de IA (exemplo para o Claude Desktop) Reinicie o cliente de IA e comece a usar
Onde consigo basic-memory?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/basicmachines-co/basic-memory

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados