How to install akitaonrails/ai-memory. Official installation instructions. Project installation guide. Framework or library installation. Build installation instructions. How to setup and install from GitHub. Installation steps and setup instructions. Official docs and installation instructions GitHub.
akitaonrails/ai-memory Installation Guide
How to install akitaonrails/ai-memory. Official project installation instructions and setup guide.
⚡
Automated Install (Recommended)
Quick installation instructions for akitaonrails/ai-memory. This is the fastest way to complete project installation and setup.
Install via curl
curl -fsSL https://hexmos.com/ipm-install | bash &&
ipm i akitaonrails/ai-memoryor
Install via npx
npx @hexmos/ipm i akitaonrails/ai-memoryPrerequisites
Docker
containerizationGit
version-control-systemMake
build-toolVersion: >=4.0
Node.js
programming-languageVersion: >=20
Rust
programming-languageVersion: >=1.75
NPM
package-managerVersion: >=10
YAY (AUR helper)
package-managerVersion: >=0.1.0
Manual Installation Methods
Manual installation instructions. How to install from GitHub source.
Arch Linux (AUR)
yay -S ai-memory-bin
yay -S ai-memory
mkdir -p ~/.config/ai-memory ~/.local/share/ai-memory
ai-memory --data-dir ~/.local/share/ai-memory --config ~/.config/ai-memory/config.toml init
systemctl --user enable --now ai-memory.service
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --applyDocker Installation
mkdir -p ~/.local/bin
wrapper_tmp=$(mktemp -d)
trap 'rm -rf "$wrapper_tmp"' EXIT
wrapper_base=https://github.com/akitaonrails/ai-memory/releases/latest/download/ai-memory-wrapper
curl -fsSL "$wrapper_base" -o "$wrapper_tmp/ai-memory-wrapper"
curl -fsSL "$wrapper_base.sha256" -o "$wrapper_tmp/ai-memory-wrapper.sha256"
expected="$(awk 'NR == 1 { print $1 }' "$wrapper_tmp/ai-memory-wrapper.sha256")"
if command -v sha256sum >/dev/null 2>&1; then actual="$(sha256sum "$wrapper_tmp/ai-memory-wrapper" | awk '{ print $1 }')"; else actual="$(shasum -a 256 "$wrapper_tmp/ai-memory-wrapper" | awk '{ print $1 }')"; fi
[ -n "$expected" ] && [ "$actual" = "$expected" ] || { echo "wrapper checksum mismatch" >&2; exit 1; }
install -m 0755 "$wrapper_tmp/ai-memory-wrapper" ~/.local/bin/ai-memory
rm -rf "$wrapper_tmp"
docker run -d --name ai-memory --restart unless-stopped -p 127.0.0.1:49374:49374 -v ai-memory-data:/data -e AI_MEMORY_LLM_PROVIDER=anthropic -e ANTHROPIC_API_KEY=sk-ant-... -e AI_MEMORY_EMBEDDING_PROVIDER=openai -e OPENAI_API_KEY=sk-...
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --applymacOS Native Binary
curl -LO https://github.com/akitaonrails/ai-memory/releases/latest/download/ai-memory-macos-aarch64.tar.gz
tar -xzf ai-memory-macos-aarch64.tar.gz
sudo mv ai-memory /usr/local/bin/
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --applyWindows Native Binary (via PowerShell)
Invoke-WebRequest -Uri https://github.com/akitaonrails/ai-memory/releases/latest/download/ai-memory-windows-x86_64.zip -OutFile ai-memory-windows-x86_64.zip
Expand-Archive -Path ai-memory-windows-x86_64.zip -DestinationPath .
Copy-Item -Path ".\ai-memory.exe" -Destination "C:\Program Files\ai-memory\ai-memory.exe" -Force
Add-Content -Path $env:PATH -Value "C:\Program Files\ai-memory"
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --applyPost Installation Steps
- Refer to the documentation for detailed configuration and usage.
- Ensure your chosen agent CLI (e.g., Claude Code, Codex) is installed and configured.
