blackbird README

The project's README from github.com/antoniaci/blackbird. As one markdown file: README.md.

Blackbird

Blackbird is a powerful OSINT tool that combines fast username and email searches across more than 600 platforms with free AI-powered profiling. By leveraging community-driven projects like WhatsMyName, it ensures low false positive rates and high-quality results. Features include smart filters, polished PDF/CSV exports, and fully automated analysis — all from a single CLI.


SherlockEyeCover

Setup

Clone the repository

git clone https://github.com/p1ngul1n0/blackbird
cd blackbird

Install requirements

pip install -r requirements.txt

OTinstaller (Linux)

You can also install Blackbird with OTinstaller, a third-party installer. Report install problems on its issue tracker.

pipx install otinstaller
otinstaller init
otinstaller install blackbird
otinstaller run blackbird -- --username johndoe

With OTinstaller, use otinstaller run blackbird -- <options> in place of python blackbird.py <options> in the examples below.

Usage

Search by username

python blackbird.py --username johndoe

Search by email

python blackbird.py --email [email protected]

Export results to PDF

python blackbird.py --email  --pdf

✨ AI (Free)

Blackbird integrates an AI engine that analyzes the sites where a username or email is found and returns a behavioral and technical profile of the user — helping you understand more, with less effort.

Generate an API key:

python blackbird.py --setup-ai

Use it

python blackbird.py --username johndoe --ai

More

For more details about the project, visit the Docs

Project Developer

Lucas Antoniaci

WhatsMyName

Blackbird is fully integrated with WhatsMyName project, witch has 600+ sites to perform accurate reverse username search.

Sponsors

DigitalOcean Referral Badge

Disclaimer

This or previous program is for Educational purpose ONLY. Do not use it without permission. 
The usual disclaimer applies, especially the fact that me (P1ngul1n0) is not liable for any 
damages caused by direct or indirect use of the information or functionality provided by these 
programs. The author or any Internet provider bears NO responsibility for content or misuse 
of these programs or any derivatives thereof. By using these programs you accept the fact 
that any damage (dataloss, system crash, system compromise, etc.) caused by the use of these 
programs is not P1ngul1n0's responsibility.

blackbird (antoniaci/blackbird)

Searching Database…

9.9K ·GitHub
Blackbird
What is this?Blackbird is an OSINT tool that searches for accounts by username and email across more than 600 platforms, with free AI-based profiling on top.
Is it a CLI program or a library?It is a command-line program written in Python and run from a single script, blackbird.py.
How do I get it running?Clone the repository, install its requirements, then run python blackbird.py. A third-party installer called OTinstaller also exists, and it runs Blackbird with otinstaller run blackbird.
What do I need before I start?Python and the packages from the requirements install step. The AI profiling needs an API key that you generate yourself.
Are there limits on the free AI part?Usage is free but capped by a fair daily limit. AI results also appear in PDF exports.
Does the AI profiling send my data anywhere?According to the README, only site names are sent to the AI engine, not sensitive data.
What does the AI profile actually contain?It analyzes the sites where a username or email is found and returns a behavioral and technical profile of the user, so you understand more with less effort.
How accurate are the search results?The README says the community-driven WhatsMyName base keeps false positive rates low, but it gives no exact figures.
Can I export the findings?Yes, results can be exported to PDF and CSV, and the features include smart filters and polished exports.
What are similar projects?maigret, GhostTrack, awesome-osint, social-analyzer, d0rk3r, sherlock, OneForAll, httpx
Which topics is it in?export, osint-tool, information-gathering, reconnaissance, csv, social-media, osint, pentesting, ai-tools, cybersecurity, pdf, security-tools
Creator
antoniaci
Size
14.2 MB
Stars
9.9K
Updated
CommitNov 03
Age
4y
Commits · 90 Days