Cómo instalar Holehe, guía paso a paso
Esta guía te muestra cómo instalar Holehe en Linux, macOS, Windows y Docker, y cómo verificar que todo funciona. Antes de empezar: si solo quieres un informe ya, la versión online no requiere ninguna instalación.
La vía rápida, usa Holehe online
Antes de instalar nada, ten en cuenta que holehe-osint.com es Holehe completo dentro del navegador. Sin dependencias de Python, sin terminal y sin conflictos de versión: pegas un email y el informe aparece en segundos. Es la opción recomendada si solo quieres un resultado rápido.
Instalar Holehe en Linux y macOS
Holehe es un paquete de Python publicado en PyPI. La forma limpia es usar siempre un entorno virtual para no contaminar el Python del sistema.
- Comprueba tu versión de Python:
python3 --version. Apunta a 3.10 o 3.11. - Crea un entorno virtual:
python3 -m venv .venv - Actívalo:
source .venv/bin/activate - Actualiza pip:
pip install --upgrade pip - Instala Holehe:
pip install holehe
En macOS, si python3 no está instalado, lo más sencillo es usar Homebrew: brew install [email protected].
Instalar Holehe en Windows
En Windows puedes instalar Holehe vía Python para Windows, WSL o Docker. Cada vía tiene sus trampas: políticas de ejecución de PowerShell, conflictos de versión de Python, dependencias que no se llevan bien con Windows nativo…
Tenemos una guía dedicada que cubre los tres métodos en detalle, con los comandos exactos y los errores más comunes: Holehe para Windows →
Instalar Holehe con Docker (opcional)
Si prefieres aislar Holehe por completo de tu sistema anfitrión, Docker es una excelente opción. Obtienes un entorno de Python congelado, independiente de tu SO.
- Crea un
Dockerfilecon una imagen base de Python 3.11 - Añade
RUN pip install holehe - Construye la imagen:
docker build -t holehe . - Ejecuta:
docker run --rm holehe [email protected]
Verifica tu instalación
Una vez instalado Holehe, ejecuta una prueba rápida para confirmar que todo funciona:
holehe [email protected]
Deberías ver Holehe enumerar los módulos uno a uno y mostrar un veredicto «Encontrado» o «No encontrado» para cada sitio. Si ves un informe en colores avanzando, la instalación fue exitosa.
Resolver errores comunes
- aiohttp no compila: actualiza pip, instala las herramientas de compilación de tu SO o baja a Python 3.11.
- Errores SSL / de certificado: ejecuta
pip install --upgrade certifi. - Conflictos de versión: borra tu venv, vuélvelo a crear e instala Holehe desde cero.
- Módulo no encontrado: comprueba que tu venv esté activado antes de lanzar el comando
holehe.
Preguntas frecuentes
- ¿Qué versión de Python necesito para Holehe?
- Holehe funciona mejor con Python 3.10 o 3.11. Las versiones más nuevas (3.12+) pueden provocar conflictos de dependencias con aiohttp y httpx. Si estás atrapado en Python 3.12+, usa un virtualenv fijado a 3.11, instálalo vía pyenv, o simplemente usa holehe-osint.com que no requiere Python en absoluto.
- ¿Puedo instalar Holehe sin sudo ni root?
- Sí. El método recomendado es crear un entorno virtual («python -m venv .venv»), activarlo y luego ejecutar «pip install holehe». Esto instala Holehe y sus dependencias dentro de la carpeta del venv, sin acceso root, sin cambios en el sistema y sin riesgo de romper el Python de tu distribución.
- ¿Holehe funciona en Mac M1, M2 o M3 (Apple Silicon)?
- Sí. Holehe es Python puro y se ejecuta de forma nativa en Apple Silicon. Instala Python con Homebrew («brew install [email protected]»), crea un venv y ejecuta «pip install holehe». Si aiohttp falla al compilar wheels, actualiza primero pip con «pip install --upgrade pip».
- ¿Se puede instalar Holehe en Termux o Android?
- Sí, pero es complicado: instala pkg termux, luego python, después «pip install holehe» dentro de un venv. Algunas dependencias (lxml, cryptography) pueden necesitar herramientas de compilación. Para la mayoría de usuarios Android, lo más sencillo es abrir holehe-osint.com directamente en el navegador móvil, misma cobertura, sin configuración.
- ¿Cómo soluciono los errores de pip más comunes con Holehe?
- Los dos errores más frecuentes son: (1) fallos de compilación de aiohttp, soluciona actualizando pip e instalando herramientas de compilación, o fija Python a 3.11; (2) errores de SSL o de certificado, soluciona con «pip install --upgrade certifi». Si los conflictos persisten, borra el venv y reinstala desde cero.