Como instalar o Holehe, guia passo a passo

O caminho rápido, use o Holehe online

Antes de instalar qualquer coisa, saiba que holehe-osint.com é o Holehe completo dentro do navegador. Sem dependências de Python, sem terminal, sem conflitos de versão: cole um e-mail e o relatório aparece em segundos. É a opção recomendada se você só quer um resultado rápido.

Executar um scan do Holehe sem instalar →

Instalar o Holehe no Linux e macOS

O Holehe é um pacote Python publicado no PyPI. A forma limpa é sempre usar um ambiente virtual para não poluir o Python do sistema.

1. Cheque sua versão do Python: python3 --version. Use 3.10 ou 3.11.
2. Crie um ambiente virtual: python3 -m venv .venv
3. Ative: source .venv/bin/activate
4. Atualize o pip: pip install --upgrade pip
5. Instale o Holehe: pip install holehe

No macOS, se python3 não estiver instalado, o mais fácil é usar o Homebrew: brew install [email protected].

Instalar o Holehe no Windows

No Windows você pode instalar o Holehe via Python para Windows, WSL ou Docker. Cada caminho tem suas armadilhas: políticas de execução do PowerShell, conflitos de versão do Python, dependências que não se dão bem com Windows nativo…

Temos um guia dedicado cobrindo os três métodos em detalhes, com os comandos exatos e os erros mais comuns: Holehe para Windows →

Instalar o Holehe com Docker (opcional)

Se você prefere isolar o Holehe completamente do sistema hospedeiro, o Docker é uma ótima opção. Você ganha um ambiente Python congelado, independente do seu SO.

1. Crie um Dockerfile com uma imagem base de Python 3.11
2. Adicione RUN pip install holehe
3. Construa a imagem: docker build -t holehe .
4. Execute: docker run --rm holehe [email protected]

Verificar sua instalação

Após instalar o Holehe, rode um teste rápido para confirmar que tudo está funcionando:

holehe [email protected]

Você deve ver o Holehe listar os módulos um a um e exibir um veredito «Encontrado» ou «Não encontrado» para cada site. Se enxergar um relatório colorido rolando, a instalação deu certo.

Resolver erros comuns

• aiohttp não compila: atualize o pip, instale as build tools do seu SO ou volte ao Python 3.11.
• Erros de SSL / certificado: rode pip install --upgrade certifi.
• Conflitos de versão: apague o venv, recrie e reinstale o Holehe do zero.
• Módulo não encontrado: confirme que seu venv está ativado antes de rodar o comando holehe.

Perguntas frequentes

Qual versão do Python preciso para o Holehe?

O Holehe funciona melhor com Python 3.10 ou 3.11. Versões mais novas (3.12+) podem causar conflitos de dependências com aiohttp e httpx. Se você está preso no Python 3.12+, use um virtualenv fixado em 3.11, instale via pyenv, ou simplesmente use holehe-osint.com, que não exige Python algum.

Posso instalar o Holehe sem sudo ou root?

Sim. O método recomendado é criar um ambiente virtual ("python -m venv .venv"), ativá-lo e então rodar "pip install holehe". Isso instala o Holehe e suas dependências dentro da pasta do venv, sem acesso root, sem alterar o sistema e sem risco de quebrar o Python da sua distro.

O Holehe funciona em Mac M1, M2 ou M3 (Apple Silicon)?

Sim. O Holehe é Python puro e roda nativamente no Apple Silicon. Instale o Python via Homebrew ("brew install [email protected]"), crie um venv e rode "pip install holehe". Se o aiohttp falhar ao compilar wheels, atualize primeiro o pip com "pip install --upgrade pip".

Dá para instalar o Holehe no Termux ou no Android?

Sim, mas é trabalhoso: instale pkg termux, depois python, em seguida "pip install holehe" dentro de um venv. Algumas dependências (lxml, cryptography) podem exigir ferramentas de build. Para a maioria dos usuários Android, o mais simples é abrir holehe-osint.com direto no navegador do celular, mesma cobertura, zero configuração.

Como corrijo os erros mais comuns de pip com o Holehe?

Os dois erros mais frequentes são: (1) falhas de build do aiohttp, corrija atualizando o pip e instalando ferramentas de build, ou fixe o Python em 3.11; (2) erros de SSL ou certificado, corrija com "pip install --upgrade certifi". Se os conflitos persistirem, apague o venv e reinstale do zero.