Monta uma equipa de funcionários virtuais que trata do teu email, atende clientes, analisa os dados do teu site e gere as campanhas no Google e no Meta: praticamente tudo o que farias. Corre no teu próprio servidor, com as tuas chaves, sob o teu controlo.
# install (one line)
curl -fsSL https://pepe-agent.com/install.sh | sh
# scaffold, connect a model, add an agent
pepe setup
pepe model add openrouter --api-key '${OPENROUTER_API_KEY}' --model openai/gpt-5-chat
pepe agent add assistant --tools bash,web_search,send_file
# talk to it, or serve it to every surface
pepe run assistant "summarize this repo"
pepe serve --port 4000Um prompt dá-te um turno: o agente responde e és tu que decides se está bom. Assim, és tu o ponto de estrangulamento, quem aprova e quem faz o controlo de qualidade ao mesmo tempo, e o trabalho só avança enquanto estás ao teclado. Dá-lhe antes um objetivo: diz o que significa "concluído", e o Pepe continua a trabalhar até um revisor independente concordar que foi atingido.
# um prompt dá uma resposta, e quem a julga és tu
pepe run "limpar a lista de clientes"
# um objetivo insiste até um revisor dizer que está concluído
pepe goal "limpar a lista de clientes" \
--criteria "sem e-mails duplicados, todas as linhas com telefone válido"Chama ferramentas, lê os resultados, chama mais. Para quando tem uma resposta a sério, não um palpite.
Defines o objetivo e o que conta como concluído. Quem avalia é um revisor independente, não o agente. Ainda não? Recebe o retorno e tenta de novo.
Trabalho recorrente agendado. Corre sozinho e recupera o que ficou pendente enquanto esteve desligado.
Um mesmo script pode chamar várias ferramentas com lógica condicional real numa única passagem, ou distribuir uma tarefa entre subagentes em paralelo que respondem por conta própria. Isso é engenharia de grafos na prática: um fluxo em formato de grafo, não apenas um turno de chat.
Define um agente uma vez. Usa-o na superfície certa para cada tarefa, com as mesmas ferramentas e memória.
Execuções pontuais e um REPL interativo.
Compatível com a OpenAI: /chat/completions e /models, a partir de qualquer SDK.
Uma ligação WebSocket para conversas ao vivo com streaming.
Telegram, WhatsApp, Slack, Discord, Teams, Google Chat.
Trabalhos comuns quando ligas as ferramentas certas.
Agenda publicações, responde a comentários e acompanha menções em todas as plataformas.
Lê a tua caixa de entrada, rascunha respostas e organiza mensagens por assunto.
Acompanha o gasto e o desempenho no Meta, Google e LinkedIn Ads, com relatório diário.
Responde no WhatsApp, Slack ou Telegram, com transferência humana quando for preciso.
Tarefas recorrentes e avisos pontuais quando algo muda.
Extrai números das tuas próprias ferramentas e envia um resumo periodicamente.
Acompanha o Sentry, o AppSignal e outras ferramentas de monitorização, e aponta o que precisa de atenção humana.
Consulta a tua base de dados e transforma números em próximos passos.
Transforma uma transcrição em resumo e itens de ação, entregues onde a equipa já fala.
Modelos, ferramentas, automação, plugins e controlo num runtime pequeno e auto-alojado.
Liga um canal e o agente responde por lá. Ficheiros, transferência e âmbito vêm prontos.
Cola uma única tag script na tua página e esta mesma bolha fica logo ativa, sem backend para escrever, sem passo de build. Alguns atributos opcionais definem a cor, a saudação e o idioma, para que cada visitante seja respondido no idioma do próprio site já na primeira mensagem.
Ver a documentação do widget →
Dados sensíveis nunca são enviados em claro para um modelo externo, o que ajuda a cumprir exigências como o RGPD, a LGPD e a HIPAA.
O meu NIF é 123 456 789, pode ver a minha encomenda?A mensagem tal como a escreveu.
O meu NIF é [NIF_1], pode ver a minha encomenda?O Pepe troca o dado sensível por um token antes de o pedido sair do teu servidor.
Encontrei a encomenda do [NIF_1]: sai para entrega amanhã.Raciocina sobre o token. Nunca viu o valor real, nem o guardou.
Encontrei a encomenda do 123 456 789: sai para entrega amanhã.O Pepe repõe o valor real, apenas do teu lado.
Uma ampliação do ciclo de turno: o Pepe chama o modelo, executa as ferramentas que pedir, devolve os resultados e para quando a resposta está pronta.
Envia a conversa e as ferramentas do agente ao modelo (com failover).
Executa o que o modelo pediu. Shell, ficheiros, web. Após a aprovação.
Anexa cada resultado à conversa e chama o modelo de novo.
Devolve a resposta final onde ela foi pedida e regista a execução como trace.
Pepe nasceu a resolver problemas reais numa série de empresas às quais eu prestava serviços de desenvolvimento: algumas precisavam de uma forma simples de conduzir o marketing sem aumentar a equipa; outras procuravam ligar o seu ERP e base de dados a um agente capaz de responder às dúvidas da equipa, sem comprometer a segurança. O projeto não nasceu aberto: era uma ferramenta interna, proprietária, desenvolvida à medida para cada cliente. Mas os resultados foram tão consistentes, em negócios tão distintos, que decidi dar-lhe um nome, uma identidade própria, e disponibilizá-lo como projeto de código aberto, para que qualquer pessoa o possa utilizar e contribuir.
O nome é uma referência ao universo de Chespirito, adorado em toda a América Latina. A piada do Pepe era simples: fazia exatamente o que lhe mandavam. Sem discutir, sem improvisar. Um bom resumo para um runtime de agentes.
Código aberto. Traz o teu modelo. Mantém o runtime, as chaves e os dados sob o teu controlo.