Changelog

2.0.0 (2026-06-11)

PyPI package: pip install aliens-eye with aliens_eye console command
Real ML detection: logistic-regression model trained on labeled scans, blended with the heuristic engine; pure-python inference with zero ML runtime dependencies
aliens_eye train collect / aliens_eye train fit for building datasets and retraining the model
aliens_eye selfcheck: validates detection accuracy against accounts known to exist
Rich terminal UI: live progress bar, sorted result tables, summary panels; --plain for scripts
Proxy support: --proxy (HTTP/SOCKS4/SOCKS5) and --tor
Site filtering: --site, --exclude-site, --no-nsfw
Markdown report export (--format md)
--profile quick|full|aggressive for non-interactive preset selection
--version, --sites (custom site list), --model (custom model), --no-ml
Dockerfile
Test suite (pytest) and GitHub Actions CI (lint + tests on Linux/Windows, Python 3.10–3.13)
Automated PyPI release workflow via trusted publishing

Restructured to a src/aliens_eye/ package; sites.json and the model ship as package data
Playwright is now an optional extra: pip install aliens-eye[browser]
Fingerprint cache and config moved to platform-standard directories (via platformdirs)
Confidence is now derived from a calibrated probability instead of fixed score bands