Início rápido

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

Bastam poucos comandos para instalares o Pepe, criares um agente e começares a falar com ele. O pepe setup segue sempre o caminho mais curto: modelo, chave, primeiro agente e, se quiseres, um canal.

1. Instala

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

2. Configura

pepe setup

O assistente guiado trata de escrever ~/.pepe/config.json. Quando te pedir uma chave, prefere sempre uma referência como ${OPENROUTER_API_KEY}, para o segredo em si nunca chegar a entrar no ficheiro.

3. Fala com ele

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

Se já tiveres um agente predefinido, podes dispensar o nome:

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

E para uma conversa que se prolongue:

pepe chat assistant

O pepe run responde uma vez e esquece logo tudo: nada fica guardado para a próxima execução. Se quiseres voltar a uma conversa mais tarde, no terminal, dá um nome à sessão:

pepe chat assistant --session minha-sessao

Sempre que uma ferramenta quiser agir na tua máquina, seja correr um comando ou escrever um ficheiro, o Pepe pede primeiro a tua aprovação.

4. Serve a API e o painel

pepe serve --port 4000

O mesmo agente passa agora a estar acessível de três formas:

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

Para testares a API:

curl http://localhost:4000/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"assistant","messages":[{"role":"user","content":"olá"}]}'

A API nasce local. Enquanto não criares um token, só esta máquina consegue chamar /v1, o que significa que mais ninguém chega ao teu agente. Cria um token com pepe token add antes de expores o servidor lá para fora.

5. Liga um canal

O Telegram é o teste mais rápido de todos, porque não exige nenhum URL público:

pepe gateway telegram setup
pepe gateway telegram

A partir daí, qualquer pessoa que escreva ao bot está a falar com o mesmo agente. WhatsApp, Slack, Discord, Teams e Google Chat têm cada um a sua página 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 ao longo do tempo, e vigilâncias para seres avisado uma única vez, no momento em que algo que te interessa mudar.

Próximos passos

← Docker Modelos →