
Una plataforma moderna para investigaciones visuales, flexibles y extensibles basadas en grafos. Para analistas e investigadores de ciberseguridad.
# Flowsint
[](./LICENSE)
[](./ETHICS.md)
[](https://www.buymeacoffee.com/dextmorgn)
[](https://ko-fi.com/P5P01W3GPJ)
[](https://discord.gg/aST9HMQr)
Flowsint es una herramienta de exploración de grafos OSINT de código abierto diseñada para la investigación ética, la transparencia y la verificación.
**Ética:** Por favor, lee [ETHICS.md](https://github.com/reconurge/flowsint/blob/main/ETHICS.md) para conocer las pautas de uso responsable.
<img width="1439" height="899" alt="hero-dark" src="https://assets.kitploit.com/production/public/readmes/686/f5a57590ea93594ae8e116b21cd83f8f90cb1344833f7c41594f3fd02f06d61a.png" />
https://github.com/user-attachments/assets/eaabfa81-d7b3-414d-8cf7-f69b4e37bab6
https://github.com/user-attachments/assets/7457d94a-cf1d-4a97-949f-f9b1d8d92644
https://github.com/user-attachments/assets/65c3f26e-7132-4853-be45-21b8933688bd
## Contribuciones
Flowsint aún está en desarrollo temprano y definitivamente necesita la ayuda de la comunidad. No dudes en reportar problemas, proponer funciones, etc.
## Primeros pasos
¿No quieres leer? Entendido. Aquí tienes tus instrucciones de instalación:
### Linux / macOS
#### 1. Instalar requisitos previos
- Docker
- Make
#### 2. Ejecutar el comando de instalación
```bash
git clone https://github.com/reconurge/flowsint.git
cd flowsint
make prod
```
### Windows
No se necesita Make. Funciona tanto en **Command Prompt (cmd)** como en **PowerShell**.
#### 1. Instalar requisitos previos
- [Docker Desktop](https://docs.docker.com/desktop/setup/install/windows-install/) (asegúrate de que esté **en ejecución** antes del siguiente paso)
- Git
#### 2. Clonar y configurar los archivos de entorno
```bat
git clone https://github.com/reconurge/flowsint.git
cd flowsint
copy .env.example .env
copy .env.example flowsint-api\.env
copy .env.example flowsint-core\.env
copy .env.example flowsint-app\.env
```
#### 3. Iniciar
```bat
docker compose -f docker-compose.prod.yml up -d
```
Esto descarga las imágenes precompiladas del GitHub Container Registry — no se necesita compilación local.
### Primer inicio de sesión
Luego ve a [http://localhost:5173/register](http://localhost:5173/register) y crea una cuenta. No hay credenciales ni cuentas por defecto.
> ✅ Las investigaciones OSINT requieren un alto nivel de privacidad. Todo se almacena en tu máquina.
### Desplegar en una red (equipo / servidor)
La misma configuración funciona directamente en un servidor: el frontend sirve la interfaz **y** actúa como proxy de todas las llamadas a la API internamente, por lo que no se necesita configuración adicional para los clientes.
```bash
git clone https://github.com/reconurge/flowsint.git
cd flowsint
cp .env.example .env
# Edita .env — consulta "Antes de exponer a una red" más abajo
docker compose -f docker-compose.prod.yml up -d
```
Cualquier persona en la red puede acceder a Flowsint en `http://<ip-del-servidor>:5173`.
**Antes de exponer a una red, cambia los secretos por defecto en `.env`:**
- `AUTH_SECRET` — firma los tokens de autenticación. Genera uno: `openssl rand -hex 32`
- `MASTER_VAULT_KEY_V1` — cifra las claves API almacenadas. Genera una: `python3 -c "import os, base64; print('base64:' + base64.b64encode(os.urandom(32)).decode())"`
- `NEO4J_PASSWORD` — contraseña de la base de datos Neo4j.
**También añade el nombre de host/IP de tu servidor a la lista blanca de encabezados Host** en `flowsint-app/nginx.conf` (busca `map $http_host $is_flowsint_host`). La lista blanca por defecto solo acepta `localhost` / `127.0.0.1` / `[::1]`, lo que protege las instalaciones de un solo usuario contra el rebinding de DNS; los despliegues en LAN y públicos deben incluir su propio nombre de host. Dos líneas de plantilla comentadas en el mismo bloque del mapa muestran el formato.
Solo el puerto `5173` está expuesto a la red. PostgreSQL, Redis, Neo4j y la API están vinculados a `127.0.0.1` en el servidor y solo son accesibles a través del proxy del frontend.
Para fijar una versión específica en lugar de `latest`, establece `FLOWSINT_VERSION` en `.env` (por ejemplo, `FLOWSINT_VERSION=1.2.10`).
**HTTPS (recomendado más allá de una LAN de confianza):** coloca cualquier proxy inverso delante del puerto 5173. Ejemplo con [Caddy](https://caddyserver.com/):
```
flowsint.example.com {
reverse_proxy 127.0.0.1:5173
}
```
Al usar un proxy inverso, también vincula el puerto de la aplicación a localhost en `docker-compose.prod.yml` (`"127.0.0.1:5173:8080"`) para que los clientes solo puedan acceder a través de HTTPS.
## ¿Qué es?
Flowsint es una herramienta de investigación basada en grafos centrada en el reconocimiento y OSINT (Inteligencia de Fuentes Abiertas). Permite explorar relaciones entre entidades mediante una interfaz visual de grafos y enriquecedores automatizados.
### Enriquecedores disponibles
**Enriquecedores de Dominio**
- Resolución DNS inversa - Encuentra dominios que apuntan a una IP
- Resolución DNS - Resuelve dominios a direcciones IP
- Descubrimiento de subdominios - Enumera subdominios
- Consulta WHOIS - Obtén información de registro de dominios
- Dominio a Sitio Web - Convierte dominio en entidad de sitio web
- Dominio a Dominio Raíz - Extrae el dominio raíz
- Dominio a ASN - Encuentra el ASN asociado al dominio
- Historial de Dominio - Recupera datos históricos del dominio
**Enriquecedores de IP**
- Información de IP - Obtén geolocalización y detalles de red
- IP a ASN - Encuentra el ASN para una dirección IP
**Enriquecedores de ASN**
- ASN a CIDRs - Obtén rangos de IP para un ASN
**Enriquecedores de CIDR**
- CIDR a IPs - Enumera IPs en un rango
**Enriquecedores de Redes Sociales**
- Maigret - Búsqueda de nombres de usuario en plataformas sociales
**Enriquecedores de Organización**
- Organización a ASN - Encuentra ASNs propiedad de la organización
- Información de Organización - Obtén detalles de la empresa
- Organización a Dominios - Encuentra dominios propiedad de la organización
**Enriquecedores de Criptomonedas**
- Cartera a Transacciones - Obtén el historial de transacciones
- Cartera a NFTs - Encuentra NFTs propiedad de la cartera
**Enriquecedores de Sitios Web**
- Rastreador de Sitios Web - Rastrea y mapea la estructura del sitio web
- Sitio Web a Enlaces - Extrae todos los enlaces
- Sitio Web a Dominio - Extrae el dominio de una URL
- Sitio Web a Rastreadores Web - Identifica scripts de seguimiento
- Sitio Web a Texto - Extrae contenido de texto
**Enriquecedores de Correo Electrónico**
- Correo a Gravatar - Encuentra el perfil de Gravatar
- Correo a Filtraciones - Consulta bases de datos de filtraciones de datos
- Correo a Dominios - Encuentra dominios asociados
**Enriquecedores de Teléfono**
- Teléfono a Filtraciones - Consulta el número de teléfono en filtraciones
**Enriquecedores de Individuos**
- Individuo a Organización - Encuentra afiliaciones organizacionales
- Individuo a Dominios - Encuentra dominios asociados a la persona
**Enriquecedores de Integración**
- Conector N8n - Conecta con flujos de trabajo N8n
## Estructura del proyecto
El proyecto está organizado en módulos autónomos:
### Módulos principales
- **flowsint-core**: Utilidades principales, orquestador, bóveda, tareas celery y clases base
- **flowsint-types**: Modelos Pydantic y definiciones de tipos
- **flowsint-enrichers**: Módulos de enriquecedores, lógica de escaneo y herramientas
- **flowsint-api**: Servidor FastAPI, rutas de API y esquemas únicamente
- **flowsint-app**: Aplicación frontend
### Dependencias entre módulos
```
flowsint-app (frontend)
↓
flowsint-api (servidor API)
↓
flowsint-core (orquestador, tareas, bóveda)
↓
flowsint-enrichers (enriquecedores y herramientas)
↓
flowsint-types (tipos)
```
## Configuración de desarrollo
### Requisitos previos
- Docker
### Ejecutar
**Linux / macOS** (requiere **Make**):
```bash
make dev
```
**Windows** (cmd o PowerShell, sin Make — crea primero los archivos `.env`, consulta [Primeros pasos](#windows)):
```bat
docker compose -f docker-compose.dev.yml up -d --build
docker compose -f docker-compose.dev.yml logs -f
```
### Desarrollo
La aplicación es accesible en [http://localhost:5173](http://localhost:5173).
## Detalles de los módulos
### flowsint-core
Utilidades principales y clases base utilizadas por todos los demás módulos:
- Conexiones a bases de datos (PostgreSQL, Neo4j)
- Autenticación y autorización
- Registro de eventos y manejo de eventos
- Gestión de configuración
- Clases base para enriquecedores y herramientas
- Funciones de utilidad
### flowsint-types
Modelos Pydantic para todos los tipos de datos:
- Dominio, IP, ASN, CIDR
- Individuo, Organización, Correo, Teléfono
- Sitio web, Perfiles sociales, Credenciales
- Carteras cripto, Transacciones, NFTs
- Y muchos más...
### flowsint-enrichers
Módulos de enriquecedores que procesan datos:
- Enriquecedores de dominio (subdominios, WHOIS, resolución)
- Enriquecedores de IP (geolocalización, consulta ASN)
- Enriquecedores de redes sociales (Maigret, Sherlock)
- Enriquecedores de correo (filtraciones, Gravatar)
- Enriquecedores cripto (transacciones, NFTs)
- Y muchos más...
### flowsint-api
Servidor FastAPI que proporciona:
- Endpoints de API REST
- Autenticación y gestión de usuarios
- Integración con base de datos de grafos
- Transmisión de eventos en tiempo real
### flowsint-app
Aplicación frontend.
- Interfaz moderna y amigable
- Diseñada para el rendimiento (sin retrasos incluso con miles de nodos)
## Flujo de trabajo de desarrollo
1. **Añadir nuevos tipos**: Añade al módulo `flowsint-types`
2. **Añadir nuevos enriquecedores**: Añade al módulo `flowsint-enrichers`
3. **Añadir nuevos endpoints de API**: Añade al módulo `flowsint-api`
4. **Añadir nuevas utilidades**: Añade al módulo `flowsint-core`
## Pruebas
Cada módulo tiene su propio conjunto de pruebas (incompleto):
```bash
# Probar el módulo core
cd flowsint-core
uv run pytest
# Probar el módulo de tipos
cd ../flowsint-types
uv run pytest
# Probar el módulo de enriquecedores
cd ../flowsint-enrichers
uv run pytest
# Probar el módulo de API
cd ../flowsint-api
uv run pytest
```
## Contribuciones
1. Sigue la estructura modular
2. Usa [uv](https://docs.astral.sh/uv/) para la gestión de dependencias
3. Escribe pruebas para la nueva funcionalidad
4. Actualiza la documentación según sea necesario
5. Consulta [CONTRIBUTING.md](https://github.com/reconurge/flowsint/blob/main/CONTRIBUTING.md) para las verificaciones que debes ejecutar antes de hacer commit
---
## ⚖️ Uso Legal y Ético
**Ética:** Por favor, lee [ETHICS.md](https://github.com/reconurge/flowsint/blob/main/ETHICS.md) para conocer las pautas de uso responsable.
Flowsint está diseñado **estrictamente para fines de investigación y análisis legales y éticos**.
Fue creado para ayudar a:
- Investigadores y analistas de ciberseguridad
- Periodistas e investigadores OSINT
- Equipos de aplicación de la ley o investigación de fraude
- Organizaciones que realizan inteligencia de amenazas interna o análisis de riesgo digital
**Flowsint no debe utilizarse para:**
- Intrusión, vigilancia o recopilación de datos no autorizada
- Acoso, doxxing o focalización de individuos
- Manipulación política, desinformación o violación de leyes de privacidad
Cualquier uso indebido de este software está estrictamente prohibido y va en contra de los principios éticos definidos en [ETHICS.md](https://github.com/reconurge/flowsint/blob/main/ETHICS.md).
## ❤️ Apoyo
[](https://www.buymeacoffee.com/dextmorgn)
[](https://ko-fi.com/P5P01W3GPJ)