basic-memory  by basicmachines-co

Knowledge management system for persistent semantic graphs from AI conversations

created 8 months ago
1,454 stars

Top 28.7% on sourcepulse

GitHubView on GitHub
Project Summary

Basic Memory is a local-first knowledge management system designed to create persistent, semantic graphs from AI conversations, storing data in Markdown files. It targets users who want to build a growing, interconnected knowledge base without relying on cloud services or complex setups, enabling LLMs to read and write to this local data.

How It Works

Basic Memory leverages the Model Context Protocol (MCP) to integrate with LLMs. It stores information as Markdown files, with specific frontmatter, observations (facts), and relations (links) defining a semantic graph. A local SQLite database indexes these files for efficient searching and retrieval. This approach allows LLMs to interact with a persistent, structured knowledge base directly through simple file operations and semantic links, facilitating context-aware conversations and knowledge synthesis.

Quick Start & Requirements

Highlighted Details

  • Local-first knowledge management using Markdown files.
  • Bidirectional read/write capabilities for LLMs and users.
  • Semantic graph construction via structured observations and relations in Markdown.
  • Real-time synchronization of local files.

Maintenance & Community

  • Developed by Basic Machines.
  • Contributions are welcome via a contributing guide.

Licensing & Compatibility

  • License: AGPL-3.0.
  • AGPL-3.0 is a strong copyleft license, requiring derivative works to also be open-sourced under AGPL-3.0. This may restrict commercial use or linking with closed-source applications.

Limitations & Caveats

The AGPL-3.0 license may impose significant restrictions on commercial adoption or integration into proprietary software. The project relies on specific LLM clients like Claude Desktop or VS Code configurations for its core functionality.

Health Check
Last commit

23 hours ago

Responsiveness

1 day

Pull Requests (30d)
10
Issues (30d)
26
Star History
866 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Travis Fischer Travis Fischer(Founder of Agentic), and
1 more.

fastmcp by punkpeye

3.7%
2k
TypeScript framework for building MCP servers handling client sessions
created 7 months ago
updated 2 days ago
Starred by Tobi Lutke Tobi Lutke(Cofounder of Shopify), Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), and
4 more.

reor by reorproject

0.2%
8k
Local AI personal knowledge management app
created 1 year ago
updated 2 months ago
Feedback? Help us improve.