Hermex: controle seu Hermes Agent pelo iPhone

A experiência do Hermes Agent auto-hospedado historicamente ficou presa ao navegador de desktop. Ou você estava no Mac ou abria um painel web remotamente. Funcionava, mas a experiência móvel sempre pareceu de segunda classe: caixas de entrada pequenas, recargas pesadas, interações que pareciam espremidas de uma interface de desktop.

Hermex quer mudar isso. É um controle remoto nativo para iPhone do Hermes Agent, escrito em Swift e SwiftUI, que traz a experiência de gerenciamento de IA auto-hospedada para o celular.

Não é um wrapper web

O maior ponto de venda do Hermex — e o mais fácil de ser ignorado — é que ele é um app nativo, não um WebView que embrulha o hermes-webui para parecer nativo.

Isso significa:

  • Respostas de chat em streaming usam renderização SSE nativa, não polling web
  • A interface é redesenhada para o iOS 18 com uma estética glass-forward
  • As credenciais de login ficam no Keychain do iOS, gerenciadas no nível do sistema
  • Lista de sessões, Tasks, Skills e navegador de arquivos são visualizações nativas independentes
  • O cache offline somente leitura de sessões recentes funciona sem rede

Em resumo, Hermex não é “uma página web enfiada em um app”. É “as capacidades do Hermes reconstruídas para mobile”.

Requer um servidor Hermes auto-hospedado

Hermex não hospeda nem executa IA por si só. É um cliente puro. Você precisa executar o serviço Hermes WebUI em um computador, NAS ou servidor que você controle (o upstream é tipicamente nesquena/hermes-webui).

Uma configuração típica se parece com isso:

Seu iPhone
    ↓ HTTPS
Cloudflare Tunnel (ou Tailscale)
    ↓ HTTP
hermes-webui rodando em 127.0.0.1:8787
    ↓ chamadas locais
Hermes Agent + toolchain

O celular é apenas o plano de controle; a computação e os dados ficam na sua própria máquina. Esse padrão “celular como cockpit, computador como motor” preserva os benefícios de privacidade do auto-hospedamento e adiciona a conveniência móvel.

Principais funcionalidades

1. Chat nativo + cadeia de raciocínio visível

Hermex suporta o envio de mensagens, anexos e imagens, e a visualização da saída do Agente em tempo real. Mais importante ainda, ele preserva os detalhes de thinking e tool-call: você pode ver o que o Hermes está raciocinando, quais ferramentas ele chamou e por que escolheu esse caminho.

Para usuários acostumados com a visualização de raciocínio do Claude ou Cursor, essa transparência é familiar.

2. Troca de modelo e perfil

Se o seu servidor estiver configurado com vários modelos ou provedores, o Hermex permite trocar diretamente no app:

  • Trocar modelos
  • Trocar o esforço de raciocínio (reasoning effort)
  • Trocar perfis de agente
  • Trocar workspaces

Não é preciso voltar ao servidor para editar variáveis de ambiente: alguns toques no celular bastam.

3. Gerenciamento de sessões

Criar, renomear, excluir, fixar, arquivar e mover sessões para projetos. O recurso Projetos permite organizar conversas por dimensão de trabalho, em vez de jogar tudo em uma única lista.

4. Tasks: ver cron jobs em movimento

As Tasks do Hermes são tarefas agendadas ou recorrentes. O Hermex fornece um painel somente leitura para revisar:

  • Quais tarefas estão em execução
  • Próxima hora de execução
  • Status histórico de execução

Quando você está fora, uma olhada rápida confirma que seu pipeline de automação ainda está saudável.

5. Skills: navegar pelas skills instaladas do agente

As Skills do Hermes são plugins de capacidade. O Hermex permite ver quais skills estão instaladas no servidor, pesquisar e navegar por elas rapidamente. Embora você ainda não possa instalá-las diretamente pelo app, já é útil para inventário móvel e compartilhamento de listas.

6. Navegador de arquivos do workspace

Agentes geram e modificam arquivos conforme trabalham. O Hermex inclui um navegador de arquivos que permite:

  • Explorar a estrutura do diretório de trabalho
  • Abrir arquivos de texto
  • Visualizar código com destaque de sintaxe (Splash para Swift, Highlightr para o resto)

Não é preciso fazer SSH de volta na máquina ou abrir um editor desktop: você pode revisar resultados no metrô.

7. Memory & Insights: painéis somente leitura

  • Memory: ver o conhecimento que o agente memorizou
  • Insights: ver consumo de tokens, estatísticas de uso e outras análises

Para quem quer observar o comportamento de longo prazo do agente e otimizar custos, esses são os dois painéis móveis mais úteis.

Implantação: três modos de conexão

Hermex suporta três rotas de conexão, classificadas pelo nível de segurança recomendado:

Método Caso de uso Nota de segurança
Cloudflare Tunnel Recomendado, domínio público com TLS real Defina uma senha forte HERMES_WEBUI_PASSWORD
Tailscale Sem exposição pública, LAN virtual direta Ideal para usuários que já usam Tailscale
Simulador local Testes de desenvolvimento, servidor e app no mesmo Mac Apenas para http://localhost:8787

Passos de configuração (Cloudflare Tunnel)

  1. Inicie o hermes-webui no macOS/Linux/Windows:
export HERMES_WEBUI_PASSWORD="sua-senha-forte"
python server.py
  1. Use o Cloudflare Tunnel para expor http://127.0.0.1:8787 para um domínio público.
  2. Baixe o Hermex no seu iPhone, insira a URL do servidor e a senha, e conecte-se.

Stack tecnológico: por que Swift nativo?

O README e a especificação do projeto do Hermex deixam o stack claro:

  • Framework de UI: SwiftUI, iOS 18+
  • Rede: URLSession nativo
  • Streaming SSE: LDSwiftEventSource
  • Renderização Markdown: swift-markdown-ui
  • Destaque de sintaxe: Splash + Highlightr
  • Cache local: SwiftData
  • Armazenamento de credenciais: Keychain

Isso mantém o app leve e evita bibliotecas de UI pesadas de terceiros, alinhado à filosofia de “equipe pequena, alto controle”.

Relação com o upstream

Hermex é um cliente comunitário independente, não afiliado ao Hermes ou ao projeto hermes-webui. Ele se comunica com o servidor através das APIs HTTP + SSE do upstream e verifica ativamente o comportamento dos endpoints.

A especificação do projeto diz:

“Não invente endpoints — verifique-os contra o servidor em execução.” “O formato do wire é a fonte da verdade.”

Essa atitude pragmática é louvável: não inventar interfaces, não fazer fork do upstream, simplesmente fazer o que um cliente deve fazer.

Quem deve usar o Hermex?

Hermex não é para todos. É melhor para:

  • Usuários que já executam um Hermes Agent auto-hospedado
  • Pessoas que querem ver ou intervir em um agente enquanto estão longe do desktop
  • Usuários móveis que exigem uma experiência nativa e não aceitam uma solução de navegador
  • Gerentes técnicos que precisam que os agentes continuem executando enquanto monitoram o status pelo celular

Se você ainda não auto-hospedou o Hermes, o Hermex não fará isso por você. É mais uma extensão que move capacidades existentes do desktop para o bolso.

Resumo

  • Hermex é um cliente iOS nativo para Hermes Agent, não um wrapper web.
  • Você traz seu próprio servidor hermes-webui; ele se conecta via Cloudflare Tunnel ou Tailscale.
  • Funcionalidades principais: chat nativo, visualização de raciocínio, troca de modelo/perfil, gerenciamento de sessões, Tasks, Skills, navegador de arquivos do workspace, painéis Memory e Insights.
  • Credenciais armazenadas no Keychain; cache offline somente leitura suportado; requer iOS 18+.
  • Melhor para usuários que já executam o Hermes e precisam de uma superfície de controle móvel.

Referências: