J.A.R.V.I.S

Manual de instalação do JARVIS GeoFiber — assistente de voz que ouve, fala, mostra o estado da rede e conversa com você no PC e no celular.

Visão geral

Três partes que trabalham juntas. Você pode usar só o PC, ou PC e celular.

JARVIS NO PC

App de janela para Windows. Rosto holográfico, voz em tempo real, controle do computador, cartões com o estado da rede, mini HUD sempre visível (F9).

JARVIS NO CELULAR

App Android. Conversa por voz com a tela apagada, cartões, confirmação de ações. Liga no servidor pela VPN da empresa.

SERVIDOR DE VOZ

Roda num servidor interno. Guarda as chaves, fala com a IA e executa as ferramentas para o celular. Só acessível pela VPN.

O que você precisa: um PC com Windows 10/11, microfone e alto-falante, uma conta Google (para a chave gratuita da IA) e, para o celular, acesso à VPN WireGuard da empresa.

1 · JARVIS no PC (Windows)

  1. Instale o Python 3.12 Baixe em python.org/downloads (versão 3.11, 3.12 ou 3.13). Na primeira tela do instalador, marque “Add python.exe to PATH”. Para conferir, abra o Prompt de Comando:
    py --version
  2. Baixe o JARVIS O código fica num repositório privado do GitHub — o administrador libera o acesso e passa o endereço. Com acesso:
    cd %USERPROFILE%\Documents
    git clone <endereço do repositório> jarvis
    cd jarvis
    Sem Git: no GitHub, botão verde Code → Download ZIP, e extraia numa pasta.
  3. Crie o ambiente e instale as dependências Leva alguns minutos (≈ 1 GB, inclui o navegador de automação):
    py -3.12 -m venv .venv
    .venv\Scripts\python.exe setup.py
    No fim aparece ✅ Setup complete!
  4. Pegue a chave Gemini (grátis) Acesse aistudio.google.com/app/apikey, entre com a conta Google e clique em Create API key. Copie o código que começa com AIza….
    Trate a chave como senha. Nunca mostre em print, vídeo ou mensagem. Se vazar, apague na mesma página e gere outra.
  5. Abra o JARVIS pela primeira vez
    .venv\Scripts\python.exe main.py
    Cole a chave em CHAVE DA API GEMINI, confira Windows e clique em INICIAR SISTEMAS. A chave fica só no seu PC, criptografada pelo Windows.
  6. Configure as integrações Em ⚙ → CONFIGURAÇÕES DOS PLUGINS, preencha o que for usar e aperte TESTAR em cada um: NOC, Pendências, Zabbix, WhatsApp, Telegram, Trello/Agenda e contas Gemini reserva. Os dados de acesso são passados pelo administrador.
  7. Crie o atalho na área de trabalho Dois cliques em criar-atalho-jarvis.bat, dentro da pasta do projeto. O ícone abre o JARVIS sem janela preta.
Chaves extras: crie mais uma ou duas chaves Gemini em outro projeto do AI Studio e coloque em ⚙ → CONFIGURAÇÕES DOS PLUGINS → GEMINI ACCOUNTS. Quando a cota diária da principal acabar, o JARVIS passa sozinho para a próxima.

2 · JARVIS no celular (Android)

Testado no POCO X4. Funciona em Android 8 ou mais novo.

  1. Receba o APK e o link de pareamento O administrador cadastra o seu aparelho no servidor e envia dois itens: o arquivo JARVIS-GeoFiber.apk e uma mensagem com um link que começa com jarvis://pair….
    O link de pareamento é a chave do seu celular. Não encaminhe para ninguém.
  2. Instale o APK Toque no arquivo. Na primeira vez o Android pede para permitir instalar apps desconhecidos pelo app de onde veio (WhatsApp, Arquivos…) — permita só para essa instalação.
  3. Pareie Segure a mensagem com o link → Copiar. Abra o JARVIS: ele lê o link copiado e se configura sozinho. Se não acontecer, toque em ⚙ → Colar link.
  4. Ligue a VPN Abra o app WireGuard e ative o perfil da empresa. Sem a VPN o JARVIS não encontra o servidor.
  5. Converse Toque em CONECTAR e permita microfone e notificações. Quando aparecer OUVINDO, é só falar. A conversa continua com a tela apagada; para encerrar, use Desconectar ou Encerrar na notificação.

Ajuste obrigatório no Xiaomi / POCO (MIUI / HyperOS)

Para o sistema não cortar a conversa em segundo plano: Configurações → Apps → JARVIS → Economia de bateria → Sem restrições. Se existir, ative também Início automático.

BotãoO que faz
ConectarLiga a conversa (precisa da VPN).
Mic ativo / mudoAbre ou fecha o microfone.
PararInterrompe o JARVIS no meio da frase.
⚙Servidor, token, nome do aparelho, colar link, microfone durante a fala.
No viva-voz o microfone fica fechado enquanto o JARVIS fala, para ele não ouvir a própria voz. Com fone de ouvido você pode desmarcar essa opção em ⚙ e interromper falando.

3 · Servidor de voz (administrador)

Ubuntu com Python 3.10 ou mais novo, acessível pela VPN. O código está na pasta server/ do repositório.

Instalar ou atualizar

# copie para o servidor: core/ memory/ plugins/ server/ e config/api_keys.json
sudo bash server/install.sh

O instalador cria o usuário jarvis, o ambiente Python, o serviço jarvis-server e faz o serviço escutar somente nos IPs privados da máquina (porta 8765). Rodar de novo atualiza o código.

Cadastrar um celular

cd /opt/jarvis-server
sudo -u jarvis env JARVIS_SERVER_DIR=/opt/jarvis-server/server/state \
  .venv/bin/python server/jarvis_server.py --add-device "Nome do aparelho"

O comando mostra o link de pareamento. Para remover um aparelho: --remove-device "Nome"; para listar: --list-devices.

Acompanhar

systemctl status jarvis-server
journalctl -u jarvis-server -f
O arquivo config/api_keys.json do servidor guarda a chave Gemini e as credenciais em texto (Linux não tem a criptografia do Windows). O instalador deixa ele legível só pelo usuário do serviço — não copie para outros lugares.

Uso diário

Exemplos de pedidos

REDE

“Jarvis, como está a rede?” · “Algum servidor com problema?” · “Quem está atacando?”

OPERAÇÃO

“O que está pendente?” · “Tem algo urgente?” · “O que o Zabbix está mostrando?”

MENSAGENS

“Manda no WhatsApp para o Anderson: o técnico chega às 15h” — você confirma na tela.

AGENDA

“Marca reunião sexta às 10h e me avisa 30 minutos antes” · “O que tenho amanhã?”

PESQUISA

“Pesquisa por dez minutos as normas da Anatel sobre compartilhamento de postes.”

PC

“Abre o navegador” · “Aumenta o volume” · “Resume este PDF” (arraste o arquivo na janela).

Atalhos no PC

TeclaAção
F4Liga/desliga o microfone
F9Mostra/esconde o mini HUD (reator sempre visível)
F11Tela cheia
EscInterrompe a fala
Ctrl + EspaçoSegurar para falar (se ativado em Controles)

Segurança

CHAVES

No PC, senhas e chaves ficam criptografadas pelo Windows; copiadas para outro PC não abrem.

CONFIRMAÇÃO

Enviar WhatsApp, desligar o PC e outras ações sem volta só acontecem depois que você aperta CONFIRMAR.

CELULAR

Cada aparelho tem o próprio token. O servidor só escuta na rede interna; fora da VPN não há como chegar nele.

SÓ LEITURA

NOC, pendências e Zabbix são consultados, nunca alterados.

Problemas comuns

“API key not valid” ou “chave inválida”

A chave foi copiada pela metade ou com espaço. Copie de novo pelo ícone de copiar do AI Studio e cole outra vez.

O JARVIS para de responder no meio do dia

A cota gratuita diária do Gemini acabou. Adicione chaves reserva em GEMINI ACCOUNTS ou aguarde a renovação.

Celular: “Sem conexão… Está na VPN?”

Ligue a VPN WireGuard. Se já estiver ligada, o perfil precisa liberar a rede interna da empresa — fale com o administrador.

Celular: “Token recusado — refaça o pareamento”

O aparelho foi removido ou recadastrado no servidor. Peça um novo link de pareamento.

Celular: a conversa cai quando a tela apaga

Faça o ajuste de bateria do MIUI/HyperOS (seção do celular) e não feche o app pela lista de recentes.

PC: o microfone não funciona

Windows → Configurações → Privacidade → Microfone → permitir para aplicativos da área de trabalho. Em ⚙ → DISPOSITIVOS DE ÁUDIO, escolha o microfone certo.

PC: “ModuleNotFoundError”

Rode de novo .venv\Scripts\python.exe setup.py dentro da pasta do JARVIS.