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 1.0.0 · 4.5k 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-11-09 · probed over pypi5 recorded runs, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading uvloop (4.2MiB)
Downloading onnxruntime (22.7MiB)
Downloading hf-xet (4.1MiB)
Downloading pillow (6.8MiB)
Downloading sqlalchemy (4.4MiB)
Downloading pyright (5.9MiB)
Downloading asyncpg (3.6MiB)
Downloading basic-memory (1.8MiB)
Downloading openai (2.3MiB)
Downloading tokenizers (3.2MiB)
Downloading beartype (1.5MiB)
Building pymeta3==0.5.1
Building pybars3==0.9.7
Downloaded beartype
Downloaded basic-memory
Built pymeta3==0.5.1
Downloaded tokenizers
Downloaded asyncpg
Downloaded openai
Downloaded uvloop
Downloaded hf-xet
Downloaded sqlalchemy
Downloaded pillow
Built pybars3==0.9.7
Downloaded onnxruntime
Downloaded pyright
Installed 159 packages in 418ms
Usage: basic-memory [OPTIONS] COMMAND [ARGS]...
Try 'basic-memory --help' for help.
╭─ Error ──────────────────────────────────────────────────────────────────────╮
│ Missing command. │
╰──────────────────────────────────────────────────────────────────────────────╯
macOS
MCP handshake failed2026-11-09 · probed over pypi5 recorded runs, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
error: No solution found when resolving tool dependencies
cause: Because onnxruntime>=1.20.1 has no wheels with a matching Python ABI tag (e.g., `cp315`) and fastembed==0.7.4 depends on onnxruntime>1.20.0, we can conclude that fastembed==0.7.4 cannot be used.
And because only the following versions of fastembed are available:
fastembed<=0.7.4
fastembed>=0.8.0
we can conclude that fastembed>=0.7.4,<0.8.0 cannot be used. (1)
Because onnxruntime>=1.24.2 has no wheels with a matching Python ABI tag (e.g., `cp315`) and fastembed>=0.8.0 depends on onnxruntime>=1.24.2, we can conclude that fastembed>=0.8.0 cannot be used.
And because we know from (1) that fastembed>=0.7.4,<0.8.0 cannot be used, we can conclude that fastembed>=0.7.4 cannot be used.
And because basic-memory>=1.0.0 depends on fastembed>=0.7.4 and you require basic-memory==1.0.0, we can conclude that your requirements are unsatisfiable.
hint: You require CPython 3.15 (`cp315`), but we only found wheels for `onnxruntime` (v1.31.1) with the following Python ABI tags: `cp311`, `cp312`, `cp313`, `cp313t`, `cp314`, `cp314t`
Windows
MCP handshake failed2026-11-09 · probed over pypi5 recorded runs, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading pyright (5.9MiB)
Downloading openai (2.3MiB)
Downloading beartype (1.5MiB)
Downloading tokenizers (2.7MiB)
Downloading sqlalchemy (2.3MiB)
Downloading onnxruntime (14.2MiB)
Downloading basic-memory (1.8MiB)
Downloading pillow (6.9MiB)
Downloading hf-xet (3.7MiB)
Building pymeta3==0.5.1
Building pybars3==0.9.7
Built pymeta3==0.5.1
Built pybars3==0.9.7
Downloaded sqlalchemy
Downloaded hf-xet
Downloaded tokenizers
Downloaded beartype
Downloaded basic-memory
Downloaded pillow
Downloaded onnxruntime
Downloaded openai
Downloaded pyright
Installed 160 packages in 37.17s
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:
[](https://doesitinstall.com/s/io.github.basicmachines-co__basic-memory.html)