Instalación de Pinky Brain

Pinky son tres binarios pequeños y estáticos: pinky (CLI + indexador), pinky-mcp (servidor MCP para el agente) y pinky-hooks (hooks de Claude Code). No hay daemon ni servicios: un archivo brain.db y listo.

Opción 1 — Script de instalación (recomendada)

Baja el último release del CDN público, verifica el checksum e instala los tres binarios en ~/.local/bin:

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

Variables opcionales:

# 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

Plataformas con binario prebuilt: Linux x86_64 y macOS Apple Silicon (aarch64). En otras (macOS Intel, Linux arm64) compilá desde fuente (opción 3).

Opción 2 — Descarga manual

Los tarballs por plataforma con su .sha256 están en el CDN público:

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/

Opción 3 — Compilar desde fuente

Requiere 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

Opción 4 — Docker

La imagen trae pinky y pinky-mcp sin el modelo ONNX (embedder determinista, 100% offline). El índice vive en un volumen en /data:

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

Verificar la instalación

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

Siguiente paso

Seguí el Quickstart del README o HOW-IT-WORKS para conectar Pinky a tu proyecto y a Claude Code.