Instalação do Pinky Brain

Pinky são três binários pequenos e estáticos: pinky (CLI + indexador), pinky-mcp (servidor MCP para o agente) e pinky-hooks (hooks do Claude Code). Não há daemon nem serviços: um arquivo brain.db e pronto.

Opção 1 — Script de instalação (recomendada)

Baixa o último release do CDN público, verifica o checksum e instala os três binários em ~/.local/bin:

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

Variáveis opcionais:

# 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 com binário prebuilt: Linux x86_64 e macOS Apple Silicon (aarch64). Em outras (macOS Intel, Linux arm64) compile a partir do código-fonte (opção 3).

Opção 2 — Download manual

Os tarballs por plataforma com seu .sha256 estão no 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/

Opção 3 — Compilar a partir do código-fonte

Requer 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

Opção 4 — Docker

A imagem traz pinky e pinky-mcp sem o modelo ONNX (embedder determinista, 100% offline). O índice vive em um volume em /data:

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

Verificar a instalação

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

Próximo passo

Siga o Quickstart do README ou HOW-IT-WORKS para conectar o Pinky ao seu projeto e ao Claude Code.