Instale o Android
Use o Google Play normalmente; escolha Sideload só para Device Control.
Início rápido
Comece pela conexão padrão upstream. Depois, pareie o Relay quando quiser as ferramentas e os aprimoramentos adicionais que ele oferece.
Um app. Dois códigos QR. Três etapas.
Conecte o Hermes
Escaneie Connect mobile app para adicionar Dashboard/Gateway.
Pareie o Relay
Escaneie Pair new device para conceder acesso ao Relay separadamente.
Status da tradução
Esta página foi traduzida com assistência de IA e passou pelas verificações técnicas. O inglês continua sendo a fonte canônica do significado do produto e da segurança.
1. Instale o aplicativo
Para a maioria das pessoas, o Google Play é o caminho mais rápido: instalação com um toque e atualizações automáticas.
Se você quer que o Hermes leia a tela, toque, digite ou navegue pelo celular, instale o APK assinado de Sideload. As duas versões podem ficar instaladas ao mesmo tempo.
2. Inicie o Hermes
O Dashboard precisa estar acessível no telefone e ter um provedor de autenticação. hermes dashboard usa apenas loopback por padrão. Configure primeiro o login e, para LAN/VPN direto, execute hermes dashboard --host 0.0.0.0 --port 9119 --no-open. Um proxy reverso para loopback precisa da dashboard.public_url externa e de um provedor. Nunca copie o token interno para o telefone.
Escolha Hermes nearby ou Remote gateway. HTTPS é recomendado. Outros endereços HTTP exigem aceitação do risco para esta conexão, host e porta exatos. O aplicativo não detecta nem impõe proteção VPN; você assume a exposição de credenciais e conversas se a VPN cair. Mudar a origem exige novo consentimento e login. Cancelar mantém o endereço anterior; histórico e rascunhos são preservados. Direct API é uma alternativa explícita, nunca substitui automaticamente o chat Gateway. Um 401 sozinho não comprova erro em dashboard.public_url.
3. Adicione a conexão padrão
No Android, abra Connect. Use Hermes nearby ou informe manualmente o endereço do Dashboard, normalmente http://<host>:9119. Entre quando solicitado. Isso cria uma conexão padrão completa sem plugin nem URL do Relay.
4. Opcional: instale e pareie o Relay
Para a experiência completa recomendada, instale o Relay depois que a conexão padrão estiver funcionando:
bash
hermes plugins install Codename-11/hermes-relay/plugin --enable
hermes relay doctor
hermes relay start --no-sslUse --no-ssl somente em uma LAN ou VPN confiável. Para acesso fora de casa, o Tailscale é recomendado.
Depois, abra Relay → Pair new device no Web Dashboard e leia o QR de uso único em Settings → Gateways → Pair Hermes Relay.
O servidor de API continua sendo um fallback opcional. Relay não é obrigatório para upstream, mas é recomendado para Terminal/TUI, notificações, ferramentas de desktop, voz avançada, sessões Relay, Device Control e compatibilidade ou metadados de mídia. Arquivos recebidos comuns usam as rotas atuais do Dashboard.
5. Confira o status
- Chat · Ready significa que você já pode enviar mensagens.
- Manage pode pedir login no dashboard.
- Voice é liberado pela mesma sessão do dashboard.
- Direct API pode ficar indisponível sem bloquear o Chat.
- Relay · Paired confirma as extensões recomendadas; uma falha do Relay não deve bloquear o caminho upstream padrão.
6. Envie a primeira mensagem
Abra o Chat e envie uma mensagem. O indicador verde no cabeçalho confirma que a conexão ativa com o Hermes está disponível.
Instalação detalhada → · Solução de problemas → · Guia canônico em inglês →