io.github.basicmachines-co/basic-memory

Local-first knowledge management with bi-directional LLM sync via Markdown files.

io.github.basicmachines-co/basic-memory · Repository · version 0.22.1 · 3.7k stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

uvx basic-memory

Results by platform

Linux

MCP handshake failed2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading pillow (6.6MiB)
Downloading beartype (1.3MiB)
Downloading asyncpg (3.4MiB)
Downloading pyright (5.9MiB)
Downloading onnxruntime (18.3MiB)
   Building pybars3==0.9.7
   Building pymeta3==0.5.1
      Built pybars3==0.9.7
      Built pymeta3==0.5.1
 Downloaded asyncpg
 Downloaded pillow
 Downloaded beartype
 Downloaded onnxruntime
 Downloaded pyright
Installed 163 packages in 347ms
Usage: basic-memory [OPTIONS] COMMAND [ARGS]...
Try 'basic-memory --help' for help.
╭─ Error ──────────────────────────────────────────────────────────────────────╮
│ Missing command.                                                             │
╰──────────────────────────────────────────────────────────────────────────────╯

macOS

MCP handshake failed2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading beartype (1.3MiB)
Downloading pyright (5.9MiB)
Downloading onnxruntime (18.3MiB)
Downloading pillow (4.6MiB)
   Building pymeta3==0.5.1
   Building pybars3==0.9.7
      Built pybars3==0.9.7
      Built pymeta3==0.5.1
 Downloaded pillow
 Downloaded beartype
 Downloaded onnxruntime
 Downloaded pyright
Installed 161 packages in 789ms
Usage: basic-memory [OPTIONS] COMMAND [ARGS]...
Try 'basic-memory --help' for help.
╭─ Error ──────────────────────────────────────────────────────────────────────╮
│ Missing command.                                                             │
╰──────────────────────────────────────────────────────────────────────────────╯

Windows

MCP handshake failed2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Building pymeta3==0.5.1
   Building pybars3==0.9.7
Downloading pillow (6.9MiB)
Downloading beartype (1.3MiB)
Downloading pyright (5.9MiB)
Downloading onnxruntime (13.1MiB)
      Built pymeta3==0.5.1
      Built pybars3==0.9.7
 Downloaded pillow
 Downloaded onnxruntime
 Downloaded beartype
 Downloaded pyright
Installed 165 packages in 1m 05s
Usage: basic-memory [OPTIONS] COMMAND [ARGS]...
Try 'basic-memory --help' for help.
+- Error ---------------------------------------------------------------------+
| Missing command.                                                            |
+-----------------------------------------------------------------------------+

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.basicmachines-co__basic-memory.json)](https://doesitinstall.com/s/io.github.basicmachines-co__basic-memory.html)