Sobre o projeto

Hermex é um aplicativo nativo para iPhone em SwiftUI para controlar um servidor hermes-webui auto-hospedado — um cockpit móvel para um agente de IA rodando em hardware que você controla. O telefone atua como plano de controle; o agente, suas ferramentas e seus dados permanecem na sua própria máquina. O aplicativo é gratuito, não tem assinaturas nem compras dentro do aplicativo, e não inclui análises ou rastreamento. Ele se comunica apenas com o seu servidor. Notificações push opcionais ficam desativadas por padrão e passam por um relay de código aberto que você pode auto-hospedar, o qual vê tokens de dispositivo, metadados de notificação e texto cifrado, mas nunca o texto das mensagens, URLs do servidor ou credenciais. Os principais recursos incluem chat com streaming com opções de modelo, esforço de raciocínio, workspace e perfil; anexos de arquivos e imagens; a capacidade de direcionar ou interromper uma execução em andamento; navegação, busca e retomada de sessões com sessões em cache legíveis offline; troca de modelos e provedores com recentes e favoritos; organização de perfis de agente e projetos; visualização e edição de tarefas cron agendadas; navegação e busca de habilidades de agente instaladas; um navegador de arquivos do workspace; e painéis somente leitura de Memória e Insights para memória do agente e análises de uso. Hermex é apenas um cliente — ele não hospeda nem provisiona um backend. Os usuários trazem seu próprio servidor hermes-webui (um projeto de terceiros licenciado sob MIT) rodando em macOS, Linux ou Windows/WSL2 com Python 3.11+. A configuração é descrita como levando cerca de 15 minutos: execute o servidor e defina uma senha, torne-o acessível a partir do telefone e conecte-se com a URL do servidor e a senha. As opções de acessibilidade incluem HTTPS via túnel ou proxy reverso (recomendado), HTTPS privado com Tailscale Serve, ou teste local apenas no simulador via http://localhost:8787. Auto-hospedar, proteger e manter a acessibilidade são responsabilidade do usuário. Compilar a partir do código-fonte requer Xcode 26 ou mais recente (SDK do iOS 18) e um iPhone ou simulador no iOS 18+. O repositório inclui um projeto Xcode com o alvo e esquema HermesMobile, dependências do Swift Package Manager e exemplos de compilação e teste pela linha de comando. A documentação cobre o acordo de trabalho, o fluxo de desenvolvimento, as operações do TestFlight, o relato de segurança e as convenções de agente locais do repositório. Contribuições são bem-vindas sob regras estabelecidas: não invente endpoints de API ou formatos JSON, decodifique modelos Codable de forma tolerante, não adicione dependências além da lista bloqueada sem aprovação, e não modifique o servidor upstream a partir deste repositório. O projeto é licenciado sob MIT e observa que é um cliente independente não afiliado ao projeto upstream hermes-webui.