basic-memory
installs/mo · pypistarsforks
How to install basic-memory?
basicmachines-co/basic-memory
$git clone https://github.com/basicmachines-co/basic-memoryClaude, Codex, or Cursor connected in 30 seconds. No Python, no JSON, no terminal. $15.00/mo locked in for life (12.50/mo yearly pricing). 7-day free trial — cancel any time before day 7 if it's not for you. Beta pricing — sign up now and your rate never goes up. OSS users: c
README.md
| 1 | <!-- mcp-name: io.github.basicmachines-co/basic-memory --> |
| 2 | [](https://www.gnu.org/licenses/agpl-3.0) |
| 3 | [](https://badge.fury.io/py/basic-memory) |
| 4 | [](https://www.python.org/downloads/) |
| 5 | [](https://github.com/basicmachines-co/basic-memory/actions) |
| 6 | [](https://github.com/astral-sh/ruff) |
| 7 |  |
| 8 |  |
| 9 | [](https://deepwiki.com/basicmachines-co/basic-memory) |
| 10 | |
| 11 | ## Skip the install — try Basic Memory in the cloud |
| 12 | |
| 13 | Claude, Codex, or Cursor connected in 30 seconds. No Python, no JSON, no |
| 14 | terminal. **$15.00/mo locked in for life** (12.50/mo yearly pricing). 7-day free |
| 15 | trial — cancel any time before day 7 if it's not for you. Beta pricing — |
| 16 | sign up now and your rate never goes up. OSS users: code `BMFOSS` takes |
| 17 | another 20% off for 3 months. |
| 18 | |
| 19 | [Start free trial →](https://basicmemory.com?utm_source=github&utm_medium=referral&utm_campaign=readme&utm_content=banner) |
| 20 | |
| 21 | ### Basic Memory Teams is now available! |
| 22 | |
| 23 | Give your team a single, shared cloud workspace. Knowledge isn't confined to one person — anything a teammate writes is immediately available to everyone else and to their AI assistants. |
| 24 | Edit a note together in real time, hand work off between humans and agents, and build one connected knowledge base instead of scattered copies. Same pricing - start with one user and add more as needed. |
| 25 | |
| 26 | --- |
| 27 | |
| 28 | # Basic Memory |
| 29 | |
| 30 | ### Your AI never forgets again. |
| 31 | |
| 32 | Pick up right where you left off — in Claude, Codex, Cursor, ChatGPT, or |
| 33 | anything that speaks [MCP](https://modelcontextprotocol.io). Your knowledge |
| 34 | lives as Markdown files that both you and your AI can read, write, and |
| 35 | search. |
| 36 | |
| 37 | - **Local-first.** Plain text on your disk. Forever. |
| 38 | - **Two-way.** AI and humans write to the same files; sync keeps them in step. |
| 39 | - **A real knowledge graph.** Observations and wikilinks compound into context. |
| 40 | - **Semantic search.** Find notes by meaning, not just keywords. |
| 41 | - **MCP-native.** Works with every major AI client and IDE. |
| 42 | - **Progressive tool discovery.** Every tool is tagged with behavior hints |
| 43 | (read-only, destructive, idempotent) so agents pick the right tool on |
| 44 | demand — no wasted context trying things to see what they do. |
| 45 | - **Cloud, optional.** Sync across devices when you want — never required. |
| 46 | |
| 47 | ## Get started |
| 48 | |
| 49 | Pick the path that fits you. Both run the same product on the same Markdown. |
| 50 | |
| 51 | <table> |
| 52 | <tr> |
| 53 | <th width="50%">☁️ Cloud</th> |
| 54 | <th width="50%">💻 Local install</th> |
| 55 | </tr> |
| 56 | <tr> |
| 57 | <td valign="top"> |
| 58 | |
| 59 | **30 seconds.** Sign up, connect your AI client, done. |
| 60 | |
| 61 | - Works in any browser |
| 62 | - Mobile, web, desktop |
| 63 | - Cross-device sync built in |
| 64 | - We handle hosting, backups, snapshots |
| 65 | |
| 66 | **$15.00/mo locked for life** · 7-day free trial · cancel any time |
| 67 | |
| 68 | [**Start free trial →**](https://basicmemory.com?utm_source=github&utm_medium=referral&utm_campaign=readme&utm_content=quickstart) |
| 69 | |
| 70 | </td> |
| 71 | <td valign="top"> |
| 72 | |
| 73 | **2 minutes.** Install, configure your AI client, run. |
| 74 | |
| 75 | - Free forever (AGPL-3.0) |
| 76 | - All data on your disk |
| 77 | - Air-gapped friendly |
| 78 | - Requires Python via [`uv`](https://docs.astral.sh/uv/) |
| 79 | |
| 80 | ```bash |
| 81 | uv tool install basic-memory |
| 82 | ``` |
| 83 | |
| 84 | [**Configure your client ↓**](#connect-your-ai-client) |
| 85 | |
| 86 | </td> |
| 87 | </tr> |
| 88 | </table> |
| 89 | |
| 90 | ## What people are saying |
| 91 | |
| 92 | > Basic Memory changed my whole relationship with LLMs. I switched from GPT |
| 93 | > and Gemini to exclusively Claude and Claude Code because of this |
| 94 | > integration and am completely revamping all our company's processes around |
| 95 | > a Basic Memory workflow. |
| 96 | > |
| 97 | > — **Alex**, TrainerDay |
| 98 | |
| 99 | > Basic Memory is the missing 'wow' facto |
People who liked this also viewed
6 picksType
- open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)MCP ServersJul 2026
- google_workspace_mcpControl Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace / G Suite MCP Server & CLI ToolMCP ServersJul 2026
- pagerduty-mcp-serverPagerDuty's official local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account directly from your MCP-enabled client.MCP ServersJul 2026
- ms-365-mcp-serverA Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph APIMCP ServersJul 2026
- GmailManage Gmail end-to-end: send, draft, reply, forward, and bulk-modify or delete messages and threads. Organize your inbox with labels, archiving, and trashing, and retrieve messages, attachments, and profile details on demand. Access and seMCP Serversrecently
- linkedin-mcp-serverOpen-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.MCP ServersJul 2026
