Início rápido

Instale o Pepe, crie um agente e converse com ele pela primeira vez.

Em poucos comandos você instala o Pepe, cria um agente e já está conversando com ele. O pepe setup cuida do caminho mais curto: modelo, chave, primeiro agente e, se quiser, um canal.

1. Instale

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

2. Configure

pepe setup

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

3. Converse

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

Se você já marcou um agente como padrão, dá para omitir o nome:

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

Para uma conversa contínua:

pepe chat assistant

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

pepe chat assistant --session minha-sessao

Sempre que uma ferramenta quiser agir na sua máquina, rodando um comando ou escrevendo um arquivo, o Pepe pede sua aprovação antes.

4. Sirva a API e o painel

pepe serve --port 4000

Agora o mesmo agente 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. Até você 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

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

pepe gateway telegram setup
pepe gateway telegram

A partir daí, todo mundo que mandar mensagem para o bot conversa com o mesmo agente. WhatsApp, Slack, Discord, Teams e Google Chat estão cobertos 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 para você mudar.

Próximos passos

← Docker Modelos →