Installing Pinky Brain

Pinky is three small, static binaries: pinky (CLI + indexer), pinky-mcp (MCP server for the agent) and pinky-hooks (Claude Code hooks). There is no daemon and no services: a single brain.db file and you're done.

Download the latest release from the public CDN, verify the checksum and install the three binaries into ~/.local/bin:

curl -fsSL https://releases.pinkybrain.dev/install.sh | sh

Optional variables:

# Versión y carpeta destino a medida
PINKY_VERSION=v0.1.1 PINKY_BIN_DIR=/usr/local/bin \
  curl -fsSL https://releases.pinkybrain.dev/install.sh | sh

Platforms with a prebuilt binary: Linux x86_64 and macOS Apple Silicon (aarch64). On others (macOS Intel, Linux arm64) build from source (option 3).

Option 2 — Manual download

The per-platform tarballs with their .sha256 are on the public CDN:

V=v0.1.1; T=x86_64-unknown-linux-gnu   # o aarch64-apple-darwin
curl -fsSLO "https://releases.pinkybrain.dev/pinky-brain-$V-$T.tar.gz"
curl -fsSLO "https://releases.pinkybrain.dev/pinky-brain-$V-$T.tar.gz.sha256"
shasum -a 256 -c "pinky-brain-$V-$T.tar.gz.sha256"          # opcional
tar xzf "pinky-brain-$V-$T.tar.gz"
sudo install pinky-brain-*/pinky pinky-brain-*/pinky-mcp pinky-brain-*/pinky-hooks /usr/local/bin/

Option 3 — Build from source

Requires Rust ≥ 1.80 (rustup):

git clone https://github.com/mrojasabregu/pinky_brain
cd pinky_brain
make up          # compila release + instala los 3 binarios en ~/.cargo/bin
# o, sin el modelo de embeddings (más liviano, 100% offline):
cargo install --path crates/pinky-cli   --no-default-features
cargo install --path crates/pinky-mcp   --no-default-features
cargo install --path crates/pinky-hooks --no-default-features

Option 4 — Docker

The image ships pinky and pinky-mcp without the ONNX model (deterministic embedder, 100% offline). The index lives in a volume at /data:

docker build -t pinky-brain .
docker run --rm -v "$PWD/documentation:/data" pinky-brain reindex /data

Verify the installation

pinky --version
pinky doctor          # chequea sqlite-vec, schema y modelo

Next step

Follow the README Quickstart or HOW-IT-WORKS to connect Pinky to your project and to Claude Code.