<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> Aliens Eye is an advanced AI-powered OSINT tool designed to discover over 840 social media accounts by username. Targeting OSINT researchers and investigators, it offers rapid, comprehensive online presence identification via a sophisticated, ML-blended detection engine.

How It Works

The system scans 840+ platforms asynchronously using a novel approach blending a trained logistic regression ML model with 30 heuristic structural signals. Each response is converted into a 30-dimensional feature vector, analyzed by both a heuristic engine and the ML model. This dual-judge system outputs Found/Maybe/Not Found probabilities with confidence, falling back to heuristics if ML is unavailable, providing more robust detection than naive checks.

Quick Start & Requirements

Install via pip: pip install aliens-eye. Optional extras include [browser] (requires python -m playwright install chromium), [train], [correlate], [pdf], [tui], and [serve]. Docker support is available. A Tor daemon is needed for --tor proxying.

Highlighted Details

• Scans 840+ platforms with ML + heuristic detection.
• Extracts profile details, performs cross-site correlation, and recursive username expansion.
• Features domain checks, watch mode with webhook alerts, and resumable scans.
• Supports modern terminal UI, optional interactive TUI, MCP server for LLM agents, and proxy/Tor.
• Offers calibrated self-checks, retrainable ML, and flexible site filtering.
• Exports results in JSON, CSV, HTML, Markdown, PDF, GEXF, Mermaid, Maltego CSV formats.

Maintenance & Community

Issues and pull requests are welcomed, indicating an open contribution model. However, specific maintainers, sponsorships, or community channels (e.g., Discord, Slack) are not detailed in the README.

Licensing & Compatibility

The repository's license is not explicitly stated in the README. This omission hinders assessment of commercial use compatibility or closed-source linking without further clarification.

Limitations & Caveats

This tool is strictly for educational purposes and legitimate OSINT research. Users are responsible for complying with applicable laws and website terms of service. No specific technical limitations (e.g., alpha status, known bugs) are detailed beyond this usage disclaimer.