Installazione di Pinky Brain

Pinky sono tre piccoli binari statici: pinky (CLI + indicizzatore), pinky-mcp (server MCP per l'agente) e pinky-hooks (hook di Claude Code). Non c'è alcun daemon né servizi: un file brain.db ed è tutto.

Opzione 1 — Script di installazione (consigliata)

Scarica l'ultima release dalla CDN pubblica, verifica il checksum e installa i tre binari in ~/.local/bin:

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

Variabili opzionali:

# 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

Piattaforme con binario prebuilt: Linux x86_64 e macOS Apple Silicon (aarch64). Sulle altre (macOS Intel, Linux arm64) compila dal sorgente (opzione 3).

Opzione 2 — Download manuale

I tarball per piattaforma con il loro .sha256 sono sulla CDN pubblica:

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/

Opzione 3 — Compilare dal sorgente

Richiede 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

Opzione 4 — Docker

L'immagine include pinky e pinky-mcp senza il modello ONNX (embedder deterministico, 100% offline). L'indice risiede in un volume in /data:

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

Verificare l'installazione

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

Passo successivo

Segui il Quickstart del README o HOW-IT-WORKS per collegare Pinky al tuo progetto e a Claude Code.