x-impersonation-guard

Detect and report X accounts impersonating you. Local-first, explainable, safe by default.
Try it in 60 seconds
pip install --pre x-impersonation-guard
playwright install chromium
xig scan-fixture
xig doctor
xig review
The offline demo runs against fictional @alex_charts candidates and never touches the real X.
Why it exists
Creators get cloned constantly. Impersonators DM followers, run scams, and erode trust. Manual reporting is repetitive and leaves no local audit trail.
x-impersonation-guard keeps detection, review, and reporting local:
- Multi-signal scoring for likely impersonators.
- SQLite review queue with explainable signal breakdowns.
xig doctorsetup checks for Python, Playwright, config, storage, token state, and SQLite.- Dry-run evidence packages before live submission.
- Playwright Help Center reporter that fails closed when selectors drift.
Status
Current public alpha: v0.2.0-alpha.
Offline demo and PyPI install are verified. Live X API scans and live report submission are pending controlled live validation.