Osintgram en Kali Linux: instálalo, arréglalo, úsalo

Hay dos cosas de Kali que rompen una instalación de Osintgram, y ninguna de las dos la explican las páginas que ahora mismo posicionan para esta búsqueda. Las dos llegaron después de que se escribieran casi todas esas páginas.

Lo primero es el empaquetado. Osintgram no está en los repositorios de Kali, así que sudo apt install osintgram no puede funcionar por muchos artículos que impriman esa línea. Lo segundo es pip. Desde Kali 2024.4 la distribución sigue la PEP 668, así que un pip install -r requirements.txt normal fuera de un entorno virtual se niega a ejecutarse e imprime error: externally-managed-environment. Los tutoriales antiguos de Kali que siguen posicionando para esto (kalilinuxtutorials, los posts de Medium de 2021, dev.to) te dan exactamente ese comando.

Esta página cubre solo las partes específicas de Kali: la realidad del empaquetado, el muro de la PEP 668, el problema con Python 3.13, los errores que ves en un sistema de la familia Debian y en ningún otro sitio, y Termux. El material independiente de la plataforma (por qué un entorno virtual, qué versión de Python, cómo funcionan las credenciales, Windows y Docker) está en cómo instalar Osintgram, y esta página no lo repite a propósito.

¿Está Osintgram en los repositorios de Kali?

No. Comprobamos cuatro fuentes independientes el 8 de agosto de 2026; ninguna lo incluye.

Un 404 en la página de la herramienta, por sí solo, podría ser un hueco de documentación. Cuatro negativas repartidas entre el catálogo de herramientas, el GitLab de empaquetado y Debian ya no lo son. El proyecto lo confirma por omisión: el README de Datalux/Osintgram documenta exactamente una vía de instalación, que es un git clone, un entorno virtual y pip install -r requirements.txt. Tampoco hay paquete en PyPI ni script instalador: setup.sh devuelve 404 en la rama master.

Por qué fallan ahora los tutoriales antiguos de Kali

En Kali cambiaron dos cosas después de que se escribieran casi todas esas guías, y las dos rompen el copiar y pegar.

La primera es la PEP 668, que permite a una distribución marcar su instalación de Python como gestionada externamente. Kali documenta el comportamiento y las formas admitidas de esquivarlo: un entorno virtual, pipx, un paquete apt o el desaconsejado --break-system-packages. Ejecuta la línea de instalación que te dan esas guías y pip se detendrá antes de descargar nada.

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try
    apt install python3-xyz, where xyz is the package you
    are trying to install.

    If you wish to install a non-Debian-packaged Python
    package, create a virtual environment using
    python3 -m venv path/to/venv.

note: If you believe this is a mistake, please contact your
Python installation or OS distribution provider.
hint: See PEP 668 for the detailed specification.

Solo uno de esos cuatro remedios sirve para Osintgram. No hay paquete apt, como ya hemos visto. pipx instala aplicaciones de Python: necesita algo instalable con pip, y Osintgram no incluye ni setup.py ni pyproject.toml, así que no hay nada que pipx pueda instalar. Queda el entorno virtual, que es justo lo que el README te decía que hicieras desde el principio.

El segundo cambio es el intérprete. El rastreador de paquetes de Kali lista python3-defaults en la versión 3.13.9-3 en el repositorio rolling, así que una instalación rolling actual está ejecutando Python 3.13 por defecto; Kali 2024.4 fue la versión que movió el valor por defecto a 3.12, y desde entonces ha vuelto a avanzar. Osintgram no se escribió para eso. Su Dockerfile sigue fijando python:3.9.2-alpine3.13, una imagen de marzo de 2021, el README no indica ninguna versión mínima y requirements.txt fija tres paquetes a releases de entre 2019 y 2021.

Instalar esas versiones fijadas en un entorno virtual limpio de Python 3.11 con un pip actual funciona (lo hemos reproducido) y prettytable y hikerapi, que no publican wheels, se compilan desde el código fuente sin quejarse. La franja a la que apuntar es de Python 3.9 a 3.11. En Kali eso suele significar aceptar 3.13 y lidiar con las consecuencias o, si tienes instalado un intérprete más antiguo, crear el entorno con él de forma explícita: python3.11 -m venv venv en lugar de python3 -m venv venv.

Nada de esto es un ataque a esos autores: una guía de 2020 era correcta en 2020. Es un aviso sobre lo que pasa cuando sigues una página que nunca se ha revisado: acabas arreglando errores que ha creado la propia guía.

La instalación que funciona en el Kali actual

Seis pasos. Aquí no hace falta root salvo en el primero; todo lo demás ocurre en tu directorio personal y dentro del entorno virtual.

1. 1

   Instala los prerrequisitos del sistema

   Git, el módulo venv y las herramientas de compilación que gnureadline necesita si tiene que compilar. Este es el único comando que necesita sudo.

   sudo apt update
   sudo apt install -y git python3-venv build-essential libncurses-dev

2. 2

   Clona el repositorio

   Clónalo en tu directorio personal. Los tracebacks del issue tracker están llenos de /home/kali/Osintgram/, que es una convención tan buena como cualquier otra.

   git clone https://github.com/Datalux/Osintgram.git
   cd Osintgram

3. 3

   Crea y activa el entorno virtual

   Este es el paso que vuelve irrelevante la PEP 668. No pases --system-site-packages: eso reintroduce las copias gestionadas por apt que estás intentando evitar.

   python3 -m venv venv
   source venv/bin/activate

4. 4

   Instala las dependencias dentro de él

   Actualiza primero las herramientas de compilación. El prettytable==0.7.2 fijado es lo bastante antiguo como para fallar contra un setuptools desactualizado.

   pip install --upgrade pip setuptools wheel
   pip install -r requirements.txt

5. 5

   Rellena el archivo de credenciales

   El repositorio incluye config/credentials.ini con tres campos vacíos: username, password y hikerapi_token. Rellena o bien el par de Instagram o bien el token de HikerAPI. make setup te pregunta por el par y escribe el archivo por ti, pero se deja fuera la línea del token y reinicia tu caché de sesión. La decisión sobre las credenciales se trata como es debido en la guía de instalación.

   nano config/credentials.ini

6. 6

   Ejecútalo contra un objetivo

   El nombre de usuario es un argumento posicional obligatorio: main.py no arranca sin él. Añade -c <command> para ejecutar un solo comando y salir en lugar de entrar en la shell.

   python3 main.py <target username>

Dos notas al pie sobre el paso 1. python3-venv suele estar ya presente, pero en una imagen recortada de Kali no lo está, y python3 -m venv venv falla sin él; el propio mensaje de la PEP 668 te dice que te asegures de tener instalado python3-full. build-essential y libncurses-dev son un seguro más que un requisito estricto: las versiones recientes de gnureadline publican wheels manylinux2014 para x86_64 y aarch64, así que en una máquina Kali amd64 o arm64 normal pip descarga un wheel y no compila nada. Esos dos paquetes son lo que evita /usr/bin/ld: cannot find -lncurses en las máquinas donde pip sí acaba recurriendo a la distribución de código fuente.

Errores de instalación en Kali y qué significan de verdad

Estos son los fallos que aparecen específicamente en sistemas de la familia Debian, ordenados a grandes rasgos por la frecuencia con la que salen en el tracker. El texto del error es lo que pegas en un buscador; la columna del medio es lo que está pasando de verdad.

Merece la pena ampliar una fila, porque manda a la gente a perseguir el paquete equivocado. En Linux puedes encontrarte un error de pyreadline. main.py empieza con un simple try: import gnureadline / except: import pyreadline, y el marcador de entorno de requirements.txt solo instala pyreadline en Windows. Así que en Kali ese mensaje nunca va de pyreadline: significa que ha fallado la importación de gnureadline, lo que casi siempre significa que ha fallado la compilación de gnureadline. Instalar pyreadline no te va a ayudar. Arreglar ncurses sí.

Ejecutar Osintgram en Kali

Tres líneas cada vez, y la primera importa más de lo que parece.

cd ~/Osintgram
source venv/bin/activate
python3 main.py <target username>

src/config.py lee config/credentials.ini como ruta relativa, y main.py importa src.Osintgram de la misma forma. Lánzalo como python3 ~/Osintgram/main.py target desde tu directorio personal y la lectura de la configuración no encontrará absolutamente nada, o te saldrá ModuleNotFoundError: No module named 'src.Osintgram', que es justo lo que cuenta la issue #105. No hay prefijo de instalación ni script envoltorio: el directorio del clon es la aplicación.

Todo lo que la herramienta lee y escribe vive dentro de ese clon:

• ~/Osintgram/config/credentials.ini: tu nombre de usuario y contraseña de Instagram, o un token de HikerAPI.
• ~/Osintgram/config/settings.json: la sesión de login en caché. El comando cache, o lanzar con -C, la reinicia a {}.
• ~/Osintgram/output/<target>/: los resultados, como <target>_<command>.txt y .json. La salida a archivo está desactivada hasta que escribes FILE=y o JSON=y, o lanzas con -f / -j.

Una vez arranca estás en una shell interactiva con un prompt amarillo Run a command: y autocompletado con TAB sobre los nombres de los comandos. Cuidado con los pesados: los cuatro comandos de correo y teléfono hacen una llamada extra a la API por cada seguidor, sin ningún tipo de backoff, y un usuario de Kali en la issue #366 sacó 41.643 registros de fwersemail antes de que Instagram bloqueara las peticiones; el fallo que vino después los descartó todos. La referencia completa de comandos, los nombres de los archivos de salida y los comandos que ya no devuelven nada están en cómo usar Osintgram.

Kali en ARM, y Osintgram en Termux

Kali en arm64 no necesita ningún cambio en la secuencia anterior. gnureadline 8.3.3 publica wheels manylinux2014 tanto para x86_64 como para aarch64, así que la única dependencia que podría exigir un compilador normalmente no lo necesita en ninguna de las dos arquitecturas.

Osintgram en Termux

Termux no es Kali, pero es el otro sitio desde el que la gente intenta ejecutar esto en un móvil, y es el entorno donde la compilación sí es realmente inevitable. La libc bionic de Android no encaja ni con las etiquetas de wheel manylinux ni con las musl, así que pip recurre a la distribución de código fuente de gnureadline, lo que significa que clang y las cabeceras de ncurses tienen que estar ahí antes.

pkg update -y && pkg upgrade -y
pkg install -y python git clang make binutils ncurses-utils libffi openssl
git clone https://github.com/Datalux/Osintgram.git
cd Osintgram
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Termux informa de platform_system como Linux, así que el marcador de requirements.txt selecciona gnureadline y nunca pyreadline: el fallo de arranque de Windows no aplica aquí. El reporte de Termux más habitual del tracker, la issue #583, es simplemente alguien ejecutando python3 main.py antes de instalar los requisitos y obteniendo ModuleNotFoundError: No module named 'requests'. Todo lo que viene después del paso de los paquetes es idéntico al flujo de Kali, archivo de credenciales incluido, y también lo es el problema de login que viene a continuación.

Se instala. Y entonces falla el login.

Meter Osintgram en Kali es la mitad fácil. La difícil es que un login en Instagram con usuario y contraseña ya casi no funciona, y nada de lo que hagas del lado de Kali cambia eso. Si tu instalación terminó bien y la herramienta se muere en Attempt to login..., no has cometido ningún error.

El fallo es del lado del servidor. El backend clásico es instagram-private-api==1.6.0, fijado a un endpoint de Instagram que desde entonces se ha retirado, y los reportes de 2026 (issue #2627, marzo de 2026) vuelven con checkpoint_required y un checkpoint_url de https://i.instagram.com/web/unsupported_version/: Instagram rechazando la versión de la API de la librería, no tu contraseña. Hay un segundo backend: pon un token en el campo hikerapi_token de config/credentials.ini, o lanza con HIKERAPI_TOKEN=<token> python3 main.py <target> -c <command>, y main.py construye un cliente de HikerAPI en su lugar, sin ningún login de Instagram de por medio. Esa es la vía que sigue diseñada para funcionar, y los usuarios informan de que funciona, pero es un servicio de terceros de pago, implica enviar tus objetivos a ese tercero y tiene sus propias roturas de formato de respuesta, reportadas en la issue #2664.

El panorama completo del estado actual (qué se rompió, cuándo, qué sigue funcionando y cuánto cuesta) está en ¿sigue funcionando Osintgram en 2026?. Y si tu objetivo es una cuenta privada, hay un límite infranqueable que no esquiva ninguna plataforma, ni fork, ni flag.

Cuándo no merece la pena instalarlo

Hay una versión de este trabajo en la que nada de lo anterior compensa. Si necesitas datos públicos de perfil de un puñado de cuentas, y no estás tratando específicamente de aprender la herramienta o de trabajar sin conexión, entonces el clon, la cuenta desechable, la limitación de peticiones y los fallos de login no te aportan nada que no puedas conseguir más rápido.

Una consulta alojada también elimina la parte del flujo de la CLI que tiene un riesgo real en Kali: nunca pones tus propias credenciales de Instagram en un archivo, así que no hay ningún baneo por login automatizado del que preocuparse. Los mismos datos públicos, sin PEP 668.