A Homebrew tap for installing Basic Memory - an AI-powered knowledge management system with MCP server integration.

# Add this tap
brew tap basicmachines-co/basic-memory

# Install Basic Memory
brew install basic-memory

Or install directly:

brew install basicmachines-co/basic-memory/basic-memory

Install a specific beta, release candidate, or development version:

# Install a specific beta version
BM_VERSION=0.13.8b1 brew install basicmachines-co/basic-memory/basic-memory-beta

# Install a release candidate
BM_VERSION=0.13.8rc1 brew install basicmachines-co/basic-memory/basic-memory-beta

# Install a development version
BM_VERSION=0.13.8.dev1 brew install basicmachines-co/basic-memory/basic-memory-beta

Available versions can be found at: https://pypi.org/project/basic-memory/#history

• basic-memory command-line tool
• MCP server integration
• Configuration templates

After installation:

# Check version
basic-memory --version

# Use the shorthand
bm --help

You can have either the stable or beta version installed at a time:

# Switch from stable to beta
brew uninstall basic-memory
BM_VERSION=x.y.z brew install basic-memory-beta

# Switch from beta to stable
brew uninstall basic-memory-beta
brew install basic-memory

Configuration files are installed to:

• $(brew --prefix)/share/basic-memory/config/

To install from source:

brew install --HEAD basic-memory

During installation you may see an error like:

Error: Failed changing dylib ID of .../libexec/.../some_file.so
Error: Failed to fix install linkage

This is harmless. Homebrew tries to rewrite internal paths in all shared libraries, but some Python extension modules (built by Rust via maturin/PyO3) don't have enough header space for the longer paths. The installation completes successfully despite the warning, and basic-memory works normally.

1. Reinstall: brew uninstall basic-memory && brew install basic-memory
2. For beta versions: brew uninstall basic-memory-beta && BM_VERSION=x.y.z brew install basic-memory-beta
3. Clear Homebrew cache: brew cleanup basic-memory or brew cleanup basic-memory-beta

This tap is maintained at: https://github.com/basicmachines-co/homebrew-basic-memory

Report issues or submit pull requests there.