Pular para o conteúdo
Guias

O painel web e o app desktop do Hermes

O que é cada superfície e quando a barreira de autenticação é ativada

6 min de leitura

O Hermes tem quatro interfaces para um único agente: a linha de comando, uma interface de terminal, um painel no navegador e um app desktop nativo. Elas compartilham configuração, chaves, sessões, skills e memória, então uma sessão iniciada em uma continua em outra. O painel é o que as pessoas procuram, e o que tem uma regra de segurança que vale conhecer: vincule-o a qualquer endereço que não seja localhost e uma barreira de autenticação é ativada, sem nenhuma flag para desativá-la.

O painel

  • Um comando inicia um servidor local na porta 9119 e o abre no navegador; nada sai da máquina.
  • Ele funciona no nível da máquina: um servidor gerencia todos os perfis, com um seletor na barra lateral e a seleção levada na URL.
  • A página de status mostra a versão, o estado do gateway e as plataformas conectadas, as sessões ativas e recentes, e um banner de recursos quando a memória ou o disco estão acabando, incluindo uma suspeita de reinício por falta de memória na inicialização anterior.
  • A aba de chat incorpora a interface de terminal completa por meio de um pseudoterminal, com um seletor de sessões; ela exige um sistema POSIX, então o Windows nativo recebe o resto do painel sem ela.

O painel é um extra opcional: a instalação padrão vem sem a stack HTTP, e o comando diz o que instalar; o frontend é compilado sozinho na primeira execução quando o Node está presente. Configuração, chaves de API, skills, servidores MCP, modelos, cron e sessões são as páginas, e há uma API REST por baixo para scripts.

A barreira de autenticação

Vinculado ao localhost, não há login. Vinculado a qualquer outro endereço, a barreira fica ativa e toda requisição precisa de uma sessão verificada: um provedor de usuário e senha para redes confiáveis, o login do Nous Portal para qualquer coisa na internet pública, ou o seu próprio provedor OpenID Connect. Se a barreira precisar ser ativada e nenhum provedor estiver configurado, o painel se recusa a se vincular ao endereço; executado de forma interativa, ele oferece configurar um na hora. A antiga flag insecure não desativa mais a autenticação.

A barreira fica ativa se, e somente se, o host de escuta não for 127.0.0.1, ::1 ou localhost.

O app desktop

O app nativo roda no macOS, no Windows e no Linux em torno do mesmo agente: com foco no chat e saída das ferramentas em streaming, uma barra de pré-visualização para páginas e arquivos, anexos por arrastar e soltar, um medidor de uso do contexto, uma opção por sessão que dispensa os pedidos de confirmação de comandos perigosos, e uma barra lateral de projetos que varre o seu diretório pessoal em busca de repositórios, o que você pode restringir ou desativar. Ele também pode se conectar a um painel rodando em uma máquina remota, que então precisa estar vinculado a um endereço acessível e protegido pela barreira. A instalação do agente Hermes cobre como colocar qualquer um dos dois em uma máquina.

Qual superfície

  • A linha de comando e a interface de terminal, quando você vive em um terminal.
  • O painel, para gerenciar uma máquina, os perfis e as chaves dela, e para conversar pelo navegador.
  • O app desktop, para o dia a dia, com pré-visualizações e arquivos ao lado do chat.

Na Diali

A Diali oferece dois painéis no navegador para um assistente Hermes como complementos: o console web nativo do Hermes, com chat, sessões, um explorador de arquivos do espaço de trabalho e a central de controle, e o Open WebUI, um painel de chat com histórico e predefinições de prompt. Os dois ficam atrás da sua conta Diali, e não de um endereço de escuta, e o gateway com que eles falam é o da plataforma. O Hermes hospedado na Diali é a versão hospedada; Hermes vs OpenClaw compara as superfícies dos dois motores junto com o resto.

  • Quatro superfícies, um agente, estado compartilhado.
  • Localhost significa sem login; qualquer outro endereço significa uma barreira que você não pode desativar.
  • O app desktop é a superfície do dia a dia; o painel é a de gerenciamento.
Começar

Pare de ler sobre isso e crie o seu

Configure um agente, escolha um canal e coloque-o para trabalhar dentro do app que você já deixa aberto.