antoniaci/blackbird

What it does

Blackbird is a command-line OSINT tool for finding accounts tied to a username or email address. It queries a large set of social and community platforms and reports where a match appears. Results come from the community-maintained WhatsMyName list of 600+ sites, which the project uses to keep false positives low. Outputs can be exported to PDF or CSV, and an optional AI step produces a behavioral and technical profile of the person based on the matched sites README lines 1–9.

It is aimed at security researchers, penetration testers, and investigators who already have a legitimate reason to perform account enumeration. The README's disclaimer states it is for educational purposes and requires permission to use README lines 92–100.

Quick start

Prerequisites: Python and pip. Clone the repository and install dependencies:

git clone https://github.com/p1ngul1n0/blackbird
cd blackbird
pip install -r requirements.txt

Run a username search from the repository directory:

python blackbird.py --username johndoe

Search by email instead:

python blackbird.py --email johndoe@example.com

Add --pdf to export results; the README shows python blackbird.py --email johndoe@example.com --pdf as the intended form, although its displayed example omits the address README lines 54–56.

Linux users can install through the third-party OTinstaller and then replace python blackbird.py with otinstaller run blackbird -- README lines 29–34. Installer problems go to that project's issue tracker.

AI profiling

Blackbird can analyze the sites where the identifier was found and return a behavioral and technical profile. The README says only site names are sent, not sensitive data, and that usage is free with a daily fair-use limit. Generate a key first, then add --ai:

python blackbird.py --setup-ai
python blackbird.py --username johndoe --ai

AI results are included in PDF exports README lines 58–74.

Constraints

• No license is declared in the repository metadata, so reuse and redistribution terms are unclear.
• AI use depends on obtaining an API key through --setup-ai; the README does not document the service behind it or the exact daily quota.
• Searches depend on the external WhatsMyName site list, so coverage changes with that project rather than Blackbird alone.
• The README gives no supported Python version, OS matrix, or expected runtime; installation is only shown via pip and the optional Linux installer.
• Use is limited to authorized, educational contexts per the project disclaimer.

HotRepo's take

On 2026-11-06, Blackbird appeared at 14th on the Python daily list with 80 stars gained in that day's snapshot. Only one snapshot is available, so it supports a single-day observation rather than a trend. The project's pull is understandable from its scope: one CLI combining username and email enumeration with exportable reports and an optional free profiling step. The open questions for adopters are licensing and the undocumented AI backend, not the search workflow itself.