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.
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.