Install

macOS

What you will do

Install Memory Layer through Homebrew or the native .pkg, configure global and project settings, and verify the service.

Homebrew

brew tap 3vilM33pl3/memory https://github.com/3vilM33pl3/memory
brew install 3vilM33pl3/memory/memory-layer
memory wizard --global
cd /path/to/project
memory wizard --dry-run
memory wizard
memory service enable
memory doctor
memory health
memory tui

For unreleased changes, use:

brew install --HEAD 3vilM33pl3/memory/memory-layer

Native .pkg

The v2.1.0 release publishes separate native installers and matching checksums:

  • Intel Mac: memory-layer-2.1.0-macos-x86_64.pkg
  • Apple Silicon Mac: memory-layer-2.1.0-macos-aarch64.pkg

These standard packages require separately configured PostgreSQL/pgvector. If Memory already has a bundled runtime, choose the architecture-matched -application-update.pkg instead: it preserves that runtime, its data and helper launcher. The standard package refuses to overwrite a bundled runtime. Do not switch an existing bundled installation to Homebrew as an implicit migration.

Download the package for your Mac, run it, then continue with the same setup commands:

memory wizard --global
cd /path/to/project
memory wizard --dry-run
memory wizard
memory service enable
memory doctor
memory health
memory tui

If a release notes that the .pkg is unsigned, macOS may require an explicit Open action from Finder or System Settings. Homebrew remains the preferred path when you want the fewest Gatekeeper prompts.

Verify

memory --version
memory service status
memory status --project <project-slug>

Next

Read PostgreSQL and pgvector and Project wizard.

© 2026 Olivier Van Acker (3vilM33pl3). Memory Layer is AGPL-3.0-or-later with commercial licensing available.