Introdução geral
O Basic Memory é uma ferramenta para criar gráficos de conhecimento por meio do diálogo com assistentes de IA, como o Claude. Desenvolvido pela Basic Machines, seu principal recurso é salvar o conteúdo do diálogo como um arquivo Markdown, que é armazenado no computador local do usuário, garantindo que os dados estejam totalmente sob o controle do usuário. A ferramenta funciona da seguinte forma Modelo de protocolo de contexto (MCP) Colaborando com modelos grandes, a IA pode ler e gravar conhecimento para formar gráficos semanticamente conectados. Ele também oferece suporte à integração com o Obsidian para facilitar a visualização e a edição. Atualmente em versão beta, é adequado para usuários que precisam acumular conhecimento estruturado, como pesquisadores, escritores ou entusiastas da gestão do conhecimento.
Lista de funções
- O diálogo gera conhecimentoTransforme conversas naturais com IA em documentos Markdown estruturados.
- armazenamento localTodos os dados são salvos no computador do usuário e não são carregados na nuvem.
- mapeamento semânticoExtrai automaticamente as relações entre os pontos de conhecimento e gera gráficos percorríveis.
- Colaboração em modelos grandesProtocolo MCP: O protocolo MCP é usado para se comunicar com o Claude et al. modelam as interações para ler e escrever o conhecimento local.
- Integração da ObsidianVisualização e edição de arquivos Markdown diretamente na Obsidian.
- Importação de dadosSuporte para importação de diálogos existentes dos arquivos JSON do Claude.
- sincronização em tempo realMonitorar as alterações nos documentos para manter a base de conhecimento atualizada.
Usando a Ajuda
Processo de instalação
Atualmente, o Basic Memory é uma ferramenta de linha de comando e requer algumas habilidades técnicas para ser instalado. Veja a seguir as etapas detalhadas:
- Preparação do ambiente
- Certifique-se de que o Python 3.8 ou posterior esteja instalado em seu computador.
- montagem
uv
(recomendada), execute-a no terminal:pip install uv
- Instalação da memória básica
- Digite o comando no terminal:
uv tool install basic-memory
- Verifique se a instalação foi bem-sucedida e execute-a:
basic-memory --version
Se o número da versão for exibido, a instalação estará concluída.
- Digite o comando no terminal:
- Configuração do servidor MCP
- A memória básica se comunica com a IA por meio do protocolo MCP. Inicie o serviço MCP local:
uvx basic-memory mcp
- Se estiver usando o Claude, será necessário adicionar as configurações do MCP ao arquivo de configuração do Claude Desktop. Edite o arquivo (o caminho nos sistemas Mac é
~/Library/Application Support/Claude/claude_desktop_config.json
):{ "mcpServers": { "basic-memory": { "comando": "uvx". "args": ["basic-memory", "mcp"] } } }
- A memória básica se comunica com a IA por meio do protocolo MCP. Inicie o serviço MCP local:
- Projeto de inicialização
- Crie uma pasta como uma base de conhecimento, por exemplo.
~/memória básica
. - Vá para a pasta:
cd ~/basic-memory
- Inicialização:
inicialização da memória básica
- Crie uma pasta como uma base de conhecimento, por exemplo.
- Iniciar a sincronização
- Execute o comando de sincronização em tempo real:
memória básica sincronização --watch
- Execute o comando de sincronização em tempo real:
Métodos alternativos de instalação (via Smithery)
- Use o Smithery para fazer a configuração automática:
npx -y @smithery/cli install @basicmachines-co/basic-memory --client claude
- Isso instala e configura automaticamente o Basic Memory, eliminando a necessidade de editar manualmente o arquivo de configuração do Claude.
Como usar os principais recursos
1. criação de conhecimento por meio do diálogo
- Abra o Claude Desktop e dialogue com a IA. Por exemplo, "Diga-me como preparar café".
- Quando a IA responde, o Basic Memory gera automaticamente um arquivo Markdown e o salva na pasta do seu projeto (por exemplo
~/memória básica
). Exemplo de um documento:
---
título: Coffee-brewing-methods
permalink: coffee-brewing-methods
tipo: nota
tags: coffee-brewing-methods
- coffee-brewing-methods
- coffee-brewing-methods
---
# Método de preparo do café
## Observação
- MÉTODO] O café preparado manualmente tem um sabor mais delicado do que o da prensa francesa.
- Técnica] Temperatura da água de 96°C para melhor extração.
## Relações
- Relação [[fonte do grão de café]]
- Necessidades [[técnica de moagem]]
2. conhecimento de visualização e edição
- Abra a Obsidian e importe a pasta do projeto (por exemplo
~/memória básica
). - Visualize o Knowledge Graph na Obsidian e clique no arquivo para editá-lo. Por exemplo, se quiser adicionar "O soco na mão precisa de um filtro", você pode escrever isso diretamente no arquivo:
- [Ferramentas] O café preparado manualmente precisa de filtros
3. introdução de diálogos existentes
- Exporte os registros de diálogo no formato JSON do site do Claude.
- É executado no terminal:
basic-memory import --folder ~/basic-memory ~/Downloads/conversations.json
- O sistema converte o diálogo em um arquivo Markdown e o armazena na pasta especificada.
4. manter o conhecimento em sincronia
- estar em movimento
sincronização de memória básica --watch
O diálogo e a edição serão atualizados em tempo real. - Por exemplo, depois que a Obsidian modifica um arquivo, a IA lê o conteúdo mais recente para o próximo diálogo.
Detalhes do processo de operação
- Iniciando um diálogoMarkdown: faça uma pergunta no Claude e a resposta será salva automaticamente como Markdown.
- Inspeção de documentosAbra a pasta do projeto para visualizar os arquivos gerados.
- Coleta de conhecimentoAjuste de conteúdo e adição de novos links na Obsidian.
- uso contínuoCada diálogo torna o gráfico de conhecimento mais completo.
A operação dessa ferramenta é intuitiva e todos os dados são locais. Depois de instalada, alguns comandos são suficientes para começar. Ela ainda está em desenvolvimento, mas a funcionalidade principal já é prática.
cenário do aplicativo
- Gerenciamento de notas de pesquisa
Os pesquisadores discutem tópicos com a IA e o Basic Memory gera automaticamente notas estruturadas para facilitar o acompanhamento. - Acumulação de material de escrita
Os escritores conversam com a IA sobre inspiração, e a ferramenta registra e conecta o conteúdo relevante para apoiar a criação. - Criação de uma base de conhecimento pessoal
Os usuários fazem perguntas diárias à IA, como dicas de culinária, construindo gradualmente uma base de conhecimento pessoal.
QA
- Preciso fazer networking?
Sim, a comunicação com a IA requer uma rede, mas os dados são armazenados apenas localmente. - Quais são os modelos suportados?
O Claude é suportado no momento; outros modelos poderão ser adicionados no futuro. - Os dados serão perdidos?
Não, a menos que o usuário o exclua manualmente, os arquivos estarão sob controle local.