anairyspirit

anairyspirit

A personal AI memory graph that runs on your own machine. Your AI agents keep long-term memory in it over MCP and REST; apart from the model download at setup (if that breaks off, the service finishes the entity model in the background), nothing leaves the machine.

This package installs it and runs it — macOS and Linux (x86_64, arm64), Node 18 or newer, and curl (setup downloads the models with it). It carries no program itself: it downloads the release it was built for from GitHub and checks it against the checksums of that release's signed manifest before anything runs.

Install

npx anairyspirit setup

setup asks you to accept the licence (answer y), asks about encryption and the rest, shows a 24-word recovery phrase (write it down), installs the program as anairyspirit (in /usr/local/bin, or ~/.local/bin — then open a new terminal) and starts its service.

npm i anairyspirit only adds this launcher (as anairyspirit-npm); the install is the npx line above.

Windows has no build of its own: run anairyspirit in Docker Desktop, or inside WSL with the line above — https://github.com/Seventhwalllab/anairyspirit#install

Use it from an AI client

Once installed, every command goes to the installed program, so an MCP client can start it like this:

{ "command": "npx", "args": ["-y", "anairyspirit", "mcp"] }

Update

npx anairyspirit@latest update

installs the newest release over yours — your memory, settings and keys stay. An install made by Homebrew or a package is updated the way it came; the program says how.

Installed with npm i -g

The command is then anairyspirit-npm (the program itself is anairyspirit, and the two must not share a name): anairyspirit-npm setup, anairyspirit-npm update.

Other ways to install — a macOS disk image, Homebrew, Debian/Ubuntu and Fedora/openSUSE packages, Docker — and the manual: https://github.com/Seventhwalllab/anairyspirit

The program and this package are distributed under the An Airy Spirit End-User Licence Agreement: LICENSE and EULA.txt in this package, shown again by setup.