Início rápido

Instale o Pepe, crie um agente e rode a primeira conversa.

Em poucos comandos você instala o Pepe, cria um agente e conversa com ele. O pepe setup cuida do caminho mais curto: modelo, chave, agente inicial e opções de canal.

1. Instale

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

2. Configure

pepe setup

O assistente guiado cria a configuração em ~/.pepe/config.json. Quando pedir uma chave, prefira uma referência como ${OPENROUTER_API_KEY} para manter o segredo fora do arquivo.

3. Converse

pepe run assistant "quais arquivos existem neste diretório?"

Se você marcou um agente como padrão, pode omitir o nome:

pepe run "resuma o README em três tópicos"

Para uma conversa contínua:

pepe chat assistant

pepe run responde uma vez e esquece: nada passa para a próxima execução. Para retomar uma conversa no terminal mais tarde, dê um nome à sessão:

pepe chat assistant --session minha-sessao

Quando uma ferramenta quiser agir na sua máquina, como rodar um comando ou escrever um arquivo, o Pepe pede sua aprovação antes.

4. Sirva a API e o painel

pepe serve --port 4000

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

Painel local: http://localhost:4000
API compatível com OpenAI: POST /v1/chat/completions
WebSocket: ws://localhost:4000/socket/websocket

Teste 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 você não criar um token, só esta máquina consegue chamar /v1: ninguém de fora alcança seu agente. Crie um com pepe token add antes de expor o servidor.

5. Conecte um canal

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

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 ficam em Canais.

6. Automatize

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

Use tarefas agendadas para o que se repete, e vigias para ser avisado uma única vez quando algo que importa mudar.

Próximos passos

← Docker Modelos →