Pepedocs

Início rápido

Instala o Pepe, cria um agente e corre a primeira conversa.

Em poucos comandos instalas o Pepe, crias um agente e falas com ele. pepe setup segue o caminho curto: modelo, chave, primeiro agente e canal opcional.

1. Instala

curl -fsSL https://pepe-agent.com/install.sh | sh
pepe help

2. Configura

pepe setup

O assistente escreve ~/.pepe/config.json. Quando pedir uma chave, prefere uma referência como ${OPENROUTER_API_KEY} para manter o segredo fora do ficheiro.

3. Fala

pepe run assistant "que ficheiros existem neste diretório?"

Se definiste um agente predefinido, omite o nome:

pepe run "resume o README em três pontos"

Para uma conversa contínua:

pepe chat assistant

pepe run responde uma vez e esquece: nada passa para a execução seguinte. Para retomares uma conversa no terminal mais tarde, dá um nome à sessão:

pepe chat assistant --session minha-sessao

Quando uma ferramenta quiser agir na tua máquina, como correr um comando ou escrever um ficheiro, o Pepe pede a tua aprovação antes.

4. Serve a API e o painel

pepe serve --port 4000

O mesmo agente fica agora acessível em três lugares:

Testa a API:

curl http://localhost:4000/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"assistant","messages":[{"role":"user","content":"olá"}]}'
A API começa local. Enquanto não criares um token, só esta máquina consegue chamar /v1: ninguém de fora chega ao teu agente. Cria um com pepe token add antes de expores o servidor.

5. Liga um canal

Telegram é o teste mais rápido porque não exige URL público:

pepe gateway telegram setup
pepe gateway telegram

Depois disso, quem falar com o bot conversa com o mesmo agente. WhatsApp, Slack, Discord, Teams e Google Chat estão em Canais.

6. Automatiza

pepe cron add
pepe watch add "site up" --probe "curl -sf https://example.com" --every 120

Usa tarefas agendadas para o que se repete, e vigilâncias para seres avisado uma única vez quando algo que te importa mudar.

Próximos passos

← DockerModelos →