Pepedocs

Painel

Use a interface web local para inspecionar e gerenciar agentes, modelos, canais e execuções.

O painel é a interface web local iniciada por pepe serve. Use-o para conversar com agentes, inspecionar traces, gerenciar conexões de modelo, configurar canais, revisar tarefas agendadas e gerar tokens de API sem editar JSON à mão.

pepe serve          # API, painel e gateways, tudo em um processo só
# depois abra http://localhost:4000

A partir de um clone do código-fonte, gere os assets uma vez com mix assets.build antes de rodar mix pepe serve.

Sessões e conversa

O painel abre com uma lista viva de sessões à esquerda e um painel de conversa com streaming à direita. Escolha uma sessão para ler o histórico dela e falar com o agente dela, e a resposta chega token a token. O New chat começa uma sessão nova, e cada sessão mostra o agente, o modelo e a contagem de turnos; uma sessão que está rodando um turno agora ganha um indicador ao vivo, com um botão Stop ali mesmo na lista para interromper uma que travou, sem precisar abrir primeiro.

As sessões vivem dentro do processo em execução, então rode tudo a partir do único processo pepe serve. Assim o painel enxerga todas as sessões, inclusive as que chegaram pelo Telegram.

As ferramentas arriscadas também são autorizadas ali mesmo. A execução pausa e mostra um pedido de permitir/negar, que é a versão web dos botões que um usuário do Telegram recebe, a menos que o agente já tenha aquela ferramenta pré-aprovada. O agente dono onipotente nunca pergunta. Veja Segurança e ambiente isolado para entender como a barreira decide.

O que tem na barra lateral

A barra lateral espelha a CLI, então quase tudo que você faz com o comando pepe também dá para fazer aqui:

Mantendo o painel no ar

O pepe serve roda em primeiro plano: fechar o terminal ou sair da sessão encerra o processo, e o painel junto. Para um deploy de verdade, instale como serviço persistente em segundo plano: launchd no macOS, systemd --user no Linux. Ele sobrevive a logout/reboot e reinicia sozinho se cair.

pepe serve install [--port 4000]
pepe serve status
pepe serve uninstall

Só funciona no binário pepe instalado, não em mix pepe serve install. Se suas conexões de modelo referenciam segredos ${ENV_VAR}, o install lista quais são, porque o serviço sobe com um ambiente mínimo e eles precisam ser adicionados à mão no arquivo gerado.

Acesso ao painel

O painel web fica aberto em localhost por padrão, o que é conveniente para o desenvolvimento local. No momento em que você o expõe além da sua máquina, coloque-o atrás de uma senha:

pepe dashboard password '${PEPE_DASHBOARD_PASSWORD}'

Você pode passar uma senha literal ou uma referência ${ENV_VAR} para que o segredo fique fora do arquivo. Uma senha literal é hasheada antes de ser gravada na configuração, então nunca é legível a partir do arquivo (ou de um backup dele) depois de definida. Uma referência ${ENV_VAR} não tem o que hashear, já que o segredo de verdade já mora fora do arquivo. Uma vez definida a senha, o painel exige entrar em /login. Limpe-a com pepe dashboard password --clear.

Rode pepe dashboard password sem valor nenhum e ele pergunta interativamente, com a digitação escondida, útil para a senha nunca ir parar no histórico do shell ou numa listagem de ps:

pepe dashboard password

A senha é lida de dashboard.password na configuração (interpolada), com fallback para a variável de ambiente PEPE_DASHBOARD_PASSWORD. Dois ajustes relacionados reforçam um painel servido atrás de um domínio:

Vinculado a uma interface pública sem senha, o painel se fecha por padrão e bloqueia clientes remotos até que você defina uma.

Acesso remoto

Para acessar o painel ou a API de fora da sua máquina sem abrir uma porta nem montar um proxy reverso, o pepe serve pode abrir um túnel da Cloudflare (precisa do cloudflared instalado):

pepe serve --tunnel

É um túnel rápido: imprime uma URL aleatória https://<algo>.trycloudflare.com que só dura enquanto o processo roda e muda a cada vez. Não precisa de conta na Cloudflare.

Para uma URL fixa que você escolhe no seu próprio domínio, use um túnel nomeado. Duas formas:

# Sem navegador (ideal em um servidor): crie o túnel e o hostname público no
# painel do Cloudflare Zero Trust, aponte o serviço dele para http://localhost:4000,
# copie o token do conector e então:
pepe serve --tunnel --token '${CLOUDFLARE_TUNNEL_TOKEN}' --hostname pepe.example.com

# Ou com um login único no navegador (salva um cert.pem), sem token:
cloudflared tunnel login
pepe serve --tunnel --hostname pepe.example.com

Com --token, o hostname e o mapeamento de serviço ficam no painel da Cloudflare; ali o --hostname é opcional, só para imprimir a URL no boot. O token é um segredo, então passe como referência ${ENV_VAR}. Uma requisição pelo túnel é sempre tratada como pública, então defina uma senha do painel antes de depender de qualquer um desses modos.

← Hooks de privacidade (censura de dados pessoais)Referência da CLI →