Install guide

Install Pamie with Homebrew or Docker

Pamie can run as a local background service or as a Docker container with persistent storage. Both paths bind to localhost by default and require Bearer authentication for the MCP endpoint.

Homebrew Docker Quickstart

Install the binary with Homebrew

brew install kurocho/tap/pamie
pamie --version

Then start Pamie. The first start creates local storage, starts the server in the background, and prints a generated Bearer token once:

pamie start
pamie status

Run pamie token later to rotate the default token. Existing raw tokens cannot be recovered because only hashes are stored.

Run the latest Docker image

docker volume create pamie-data
export PAMIE_TOKEN="$(openssl rand -hex 32)"

docker run --rm \
  --name pamie \
  -p 127.0.0.1:17683:8080 \
  -v pamie-data:/data \
  -e PAMIE_TOKEN="$PAMIE_TOKEN" \
  -e PAMIE_TOKEN_ID=local \
  -e PAMIE_TOKEN_SCOPES=all \
  kurocho/pamie:latest

Verify the server

curl http://127.0.0.1:17683/health
curl http://127.0.0.1:17683/ready

Do not expose Pamie publicly without HTTPS termination and Bearer authentication. Keep memories free of secrets unless your deployment model and retention policy are designed for that data.

View source Docker Hub