Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Instalação

O papo é um binário único, sem runtime e sem dependências. As duas pessoas que vão conversar precisam dele instalado, cada uma na sua máquina.

Requisitos

  • Claude Code instalado e logado. Para receber mensagens por push (recomendado), o login precisa ser com conta claude.ai ou chave de API do Console. Veja Usando sem channels para os detalhes e para o modo que funciona em qualquer caso.
  • Acesso à internet. Redes que bloqueiam UDP também funcionam, porque o tráfego cai para um relay via HTTPS.

Script de instalação (Linux e macOS)

curl -fsSL https://raw.githubusercontent.com/Kelvin-Jesus/papo/main/scripts/install.sh | sh

O script detecta o sistema e a arquitetura (inclusive Apple Silicon num terminal sob Rosetta), baixa o arquivo da última release, confere o .sha256 e instala o papo em ~/.local/bin, sem sudo. Funciona com curl ou wget. Opções, depois de sh -s --:

OpçãoEfeito
--dir <diretório>Instala em outro lugar (ex.: /usr/local/bin, aí com sudo sh).
--version <vX.Y.Z>Instala uma versão específica em vez da última.

Se o diretório não estiver no PATH, o script avisa e mostra a linha para adicionar.

Também dá para pedir ao seu agente que instale e configure tudo: o README tem um prompt pronto e as instruções que ele segue.

Gerenciadores de pacotes

SistemaComando
macOS e Linux (Homebrew)brew tap kelvin-jesus/papo https://github.com/Kelvin-Jesus/papo e depois brew install papo
Arch e derivados (AUR)yay -S papo-bin (ou paru -S papo-bin)
Windows (Scoop)scoop bucket add papo https://github.com/Kelvin-Jesus/papo e depois scoop install papo
Debian e Ubuntubaixe o .deb da última release e rode sudo apt install ./papo_*_amd64.deb
Fedora, RHEL e openSUSEbaixe o .rpm da última release e rode sudo dnf install ./papo-*.rpm
Qualquer sistema com Rustcargo binstall papo (baixa o binário pronto) ou cargo install papo (compila)

Todos instalam o mesmo binário das releases do GitHub, com o mesmo SHA-256. Cada release atualiza os gerenciadores sozinha. Para atualizar, rode papo update: ele descobre por onde o papo foi instalado e usa o mesmo caminho (referência).

Binário pronto

Baixe o arquivo do seu sistema na página de Releases, extraia e coloque o papo (ou papo.exe) num diretório do PATH.

SistemaArquivo
Linux x86_64papo-<versão>-x86_64-unknown-linux-musl.tar.gz
Linux ARM64papo-<versão>-aarch64-unknown-linux-musl.tar.gz
macOS Apple Siliconpapo-<versão>-aarch64-apple-darwin.tar.gz
macOS Intelpapo-<versão>-x86_64-apple-darwin.tar.gz
Windowspapo-<versão>-x86_64-pc-windows-msvc.zip

Os binários de Linux são estáticos (musl) e rodam em qualquer distribuição. No Windows on ARM, use o binário x86_64, que roda por emulação. Cada arquivo vem acompanhado de um .sha256 para conferir a integridade.

Linux e macOS

tar -xzf papo-<versão>-<alvo>.tar.gz
sudo mv papo-<versão>-<alvo>/papo /usr/local/bin/
papo --version

Sem sudo, use um diretório do seu usuário que esteja no PATH, como ~/.local/bin.

macOS: aviso do Gatekeeper

Um binário baixado pelo navegador vem marcado como “quarentena” e o macOS pode se recusar a abri-lo. Libere com:

xattr -d com.apple.quarantine /usr/local/bin/papo

Windows

Extraia o .zip, mova o papo.exe para uma pasta (por exemplo C:\Users\<você>\bin) e adicione essa pasta ao PATH nas variáveis de ambiente do usuário. Abra um terminal novo e rode papo --version.

Compilando do código-fonte

Com Rust 1.91 ou mais novo:

git clone https://github.com/Kelvin-Jesus/papo
cd papo
cargo install --path .

Ou, sem clonar:

cargo install --git https://github.com/Kelvin-Jesus/papo

O binário vai para ~/.cargo/bin, que normalmente já está no PATH.

Conferindo

papo --version
papo --help

Pronto. O próximo passo é o Tutorial, que leva você do zero até dois agentes conversando.