Pular para o conteúdo

Instalar

Três comandos e um QR.

O caminho recomendado é o Docker: funciona igual no Linux, no Windows (com WSL2) e no Mac.

Antes de começar O Greg conecta ao WhatsApp como um aparelho a mais, por um protocolo não oficial. Os Termos do WhatsApp não autorizam isso e o número pode ser restringido. Use com o seu número e por sua conta.

Nota sincera do criadorO risco é real. Mas, do jeito que o Greg foi feito para ser usado, dificilmente leva a algum tipo de restrição: depende muito do seu uso e dos seus envios. Se por acaso você receber um primeiro aviso do WhatsApp, recomendo que reveja a sua forma de uso.

Com Docker

  1. Baixe e gere as senhas

    O script cria o docker.env com senhas aleatórias e permissão só sua.

    git clone https://github.com/userj81/vigia.git
cd vigia
bin/preparar-docker.sh

  2. Diga quem é você

    Abra o docker.env e preencha DONO_WHATSAPP (seu número com DDI e DDD, só dígitos) e o TZ (seu fuso, para o fechamento do dia às 21:00).

  3. Suba tudo

    A primeira vez demora alguns minutos: baixa a Evolution, o Postgres, o Redis e o modelo de transcrição.

    docker compose up -d --build

  4. Entre no Claude, uma vez

    Abre o Claude Code dentro do contêiner. Digite /login, entre na sua conta e saia com /exit. O login fica guardado.

    docker compose exec -it vigia claude

  5. Pareie o WhatsApp

    Abra 127.0.0.1:8120 e entre com o VIGIA_TOKEN do docker.env. Em Conexão → Gerar QR, leia o código no celular em Aparelhos conectados → Conectar um aparelho. Cada QR vale 60 segundos.

Se algo não subir

O painel não abre: confira com docker compose ps se o serviço vigia está healthy e leia o motivo em docker compose logs vigia. A porta 8120 ocupada por outro programa também impede o painel de subir.

O QR não aparece: a Evolution ainda está iniciando. Espere um minuto e clique de novo; são no máximo 3 QRs por clique e 10 por dia.

Lê mas não classifica: falta o login do Claude (passo 4).

Opções

Sem transcrição de áudio (imagem ~850 MB menor): docker compose build --build-arg TRANSCRICAO=0. Transcrição mais precisa e mais lenta: --build-arg WHISPER_MODELO=medium. Horários, janelas e tetos ficam no config.toml.

Parar: docker compose down. Apagar tudo, inclusive a sessão do WhatsApp: docker compose down -v.

Nativo no macOS

O modo original: app próprio, Touch ID para liberar envio e transcrição na GPU do Apple Silicon.

  1. Configure

    Preencha os dois arquivos; as senhas saem de openssl rand -hex 24.

    cp .env.exemplo .env
cp infra/.env.compose.exemplo infra/.env.compose
chmod 600 .env infra/.env.compose

  2. Suba a Evolution e crie a instância

    bin/evolution.sh up
bin/evolution.sh instancia

  3. Ligue o ciclo e o app

    Instala os agendamentos (ciclo de 30 minutos, painel, fechamento da semana) e compila o Greg.app.

    bin/instalar-launchagent.sh --sim
bin/construir-app.sh

  4. Pareie

    Abra o Greg.app (ou 127.0.0.1:8120) e gere o QR em Conexão.

Quer entender antes de instalar?

O que o Greg guarda, o que apaga e o que nunca sai da sua máquina.

Ler sobre privacidade