Match the project to your task before installing it.
Vector Retrieval and RAG · Public
basic-memory
Vector retrieval project for checking embedding storage, query semantics, RAG integration, data boundaries, and rollback.
Vector databaseRAGEmbeddingsSemantic searchData boundaries
Best fitDevelopers connecting knowledge bases, documents, or app data to semantic retrieval or RAG workflows.
Check whether this project matches your task before installing it.
What it can doVector database setup checks, embedding model boundaries, collection management, query acceptance, and deletion guidanceReview the portable capability path.
Before continuingVerify in a sandboxDo not treat a preview pack as a proven local install.
GitHub snapshot3.4k stars224 forks · 28 contributors
Doramagic.ai Last verification date: 2026-07-07 Verification method: source evidence, semantic profile, public page gate, and static build acceptance.
Publication status · 2026-07-07
What is basic-memory?
- basic-memory is a vector database, retrieval, or RAG storage component for AI applications.
- Best fit: Developers connecting knowledge bases, documents, or app data to semantic retrieval or RAG workflows.
- Not for: Not for one-off model API calls or environments that cannot isolate indexed data, credentials, and persistence paths.
- Capability added to an AI workflow: Vector database setup checks, embedding model boundaries, collection management, query acceptance, and deletion guidance
- First safe verification step: Verify create, query, delete, and rollback with a small public text sample before using real data.
- Verification state: source, Quick Start, and sandbox install checks are recorded as passed.
- Top risk: May increase setup, validation, or first-run risk for the user.
- Evidence base: https://github.com/basicmachines-co/basic-memory, https://github.com/basicmachines-co/basic-memory#readme, Human Manual, Pitfall Log
01
Quick decision
Use this section to decide whether the project is worth a deeper read.Vector retrieval project for checking embedding storage, query semantics, RAG integration, data boundaries, and rollback.
3.4k stars · 224 forks
02
What it can do
Translate the upstream project into concrete capabilities the user can judge before installing.Repository Overview & System Architecture
Related topics: Markdown Format, Knowledge Graph, Indexing & Search, AI Client Integrations & Plugins (Claude Code, Codex, Hermes, OpenClaw, Skills), Cloud Sync, Projects, Deployment & Com...
Source: https://github.com/basicmachines-co/basic-memory / Human Manual
Markdown Format, Knowledge Graph, Indexing & Search
Related topics: Repository Overview & System Architecture, Cloud Sync, Projects, Deployment & Common Failure Modes
Source: https://github.com/basicmachines-co/basic-memory / Human Manual
AI Client Integrations & Plugins (Claude Code, Codex, Hermes, OpenClaw, Skills)
Related topics: Repository Overview & System Architecture, Markdown Format, Knowledge Graph, Indexing & Search
Source: https://github.com/basicmachines-co/basic-memory / Human Manual
Cloud Sync, Projects, Deployment & Common Failure Modes
Related topics: Repository Overview & System Architecture, Markdown Format, Knowledge Graph, Indexing & Search
Source: https://github.com/basicmachines-co/basic-memory / Human Manual
Doramagic Pitfall Log
Source-linked risks stay visible on the manual page so the preview does not read like a recommendation.
Source: Doramagic discovery, validation, and Project Pack records
Sources: https://github.com/basicmachines-co/basic-memory, Human Manual, Project Pack evidence, and downstream validation signals.
03
Community Discussion Evidence
Project-level external discussion stays visible on the detail page, not only inside the manual.Community Discussion Evidence
12 source-linked itemsReview these external discussions before using basic-memory with real data or production workflows. They are review inputs, not standalone proof that the project is production-ready.
-
01
[BUG] Large cloud-project deletion errors opaquely; no documented way to
github / github_issue
-
02
[BUG] `DELETE /knowledge/entities/{id}` returns 500 for non-markdown (fi
github / github_issue
-
03
[BUG] .bmignore shields already-synced content from removal (no supporte
github / github_issue
-
04
[BUG] Empty ~/basic-memory directory recreated on every config load (mkd
github / github_issue
-
05
[BUG] PermissionError during project scan triggers mass index deletion
github / github_issue
-
06
[FEATURE] Please allow additional knowledge roots for safe symlink trave
github / github_issue
-
07
Query-time relation traversal in search (one-hop graph expansion)
github / github_issue
-
08
[BUG] File-watcher (direct on-disk) writes are not vector-embedded; exte
github / github_issue
-
09
v0.22.1
github / github_release
-
10
v0.22.0
github / github_release
-
11
v0.21.6
github / github_release
-
12
v0.21.5
github / github_release
04
How to start
Only source-backed commands are shown here. Verify them in an isolated environment first.Try the prompt first
Test the workflow without installing the upstream project.
previewRead the Human Manual
Understand inputs, outputs, limits, and failure modes.
manualTake context to your AI host
Use the compiled assets in your preferred AI environment.
contextRun sandbox verification
Confirm install commands and rollback before using a primary environment.
verifyuv tool install basic-memoryOfficial start command · https://github.com/basicmachines-co/basic-memory#readme · verified: yes
05
Human Manual
The English page must expose the real manual, not a short placeholder.8+ sections · Human Manual
basic-memory Manual
AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN
Open the full manual- https://github.com/basicmachines-co/basic-memory Project Manual
- Table of Contents
- Repository Overview & System Architecture
- Related Pages
- Purpose and Scope
- Component Architecture
- Configuration, Projects, and Home
- Known Architectural Friction Points
Repository Overview & System Architecture
Related topics: Markdown Format, Knowledge Graph, Indexing & Search, AI Client Integrations & Plugins (Claude Code, Codex, Hermes, OpenClaw, Skills), Cloud Sync, Projects, Deployment & Com...
Source: https://github.com/basicmachines-co/basic-memory / Human Manual
Markdown Format, Knowledge Graph, Indexing & Search
Related topics: Repository Overview & System Architecture, Cloud Sync, Projects, Deployment & Common Failure Modes
Source: https://github.com/basicmachines-co/basic-memory / Human Manual
AI Client Integrations & Plugins (Claude Code, Codex, Hermes, OpenClaw, Skills)
Related topics: Repository Overview & System Architecture, Markdown Format, Knowledge Graph, Indexing & Search
Source: https://github.com/basicmachines-co/basic-memory / Human Manual
Cloud Sync, Projects, Deployment & Common Failure Modes
Related topics: Repository Overview & System Architecture, Markdown Format, Knowledge Graph, Indexing & Search
Source: https://github.com/basicmachines-co/basic-memory / Human Manual
Doramagic Pitfall Log
Source-linked risks stay visible on the manual page so the preview does not read like a recommendation.
Source: Doramagic discovery, validation, and Project Pack records
06
AI Context Pack and portable assets
After deciding to continue, take the project context into your own AI host.Complete pack plus user-owned assets
These files are planning and verification assets for Claude Code, Codex, Gemini, Cursor, ChatGPT, and other AI hosts.
07
Preflight checks
Treat this page as a planning asset, not proof that your local environment is ready.- The manual is generated from source-linked project files and Doramagic validation signals.
- Community evidence warnings stay visible instead of being converted into marketing claims.
- This English page is indexable because the locale quality gate passed and explicit English index approval is enabled.
- Use the upstream repository as the final authority for installation commands, license, and version-specific behavior.
08
Pitfall Log and verification risks
Doramagic surfaces high-risk items before users treat a candidate capability as verified.Installation risk requires verification
May increase setup, validation, or first-run risk for the user.
Configuration risk requires verification
May increase setup, validation, or first-run risk for the user.
Security or permission risk requires verification
May increase setup, validation, or first-run risk for the user.
Security or permission risk requires verification
May increase setup, validation, or first-run risk for the user.
Security or permission risk requires verification
May increase setup, validation, or first-run risk for the user.
Installation risk requires verification
May increase setup, validation, or first-run risk for the user.
Configuration risk requires verification
May increase setup, validation, or first-run risk for the user.
Capability evidence risk requires verification
May increase setup, validation, or first-run risk for the user.