# blackbird (antoniaci/blackbird)

> 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.

- GitHub: https://github.com/antoniaci/blackbird
- GitHub.Locker page: https://github.locker/antoniaci/blackbird
- Stars: 9.9K
- Language: Python
- Last push: 2026-11-03

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**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.


---

## README (checked against GitHub 2026-11-07)

Source: https://github.com/antoniaci/blackbird/blob/main/README.md

# Blackbird

<figure><img src="./docs/.gitbook/assets/ai-demo.png" alt=""><figcaption></figcaption></figure>

> 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.
<br>

[![SherlockEyeCover](./docs/.gitbook/assets/sherlockeye_cover.jpg)](https://cutt.ly/frtVNzQQ)

### Setup

**Clone the repository**

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

**Install requirements**

```bash
pip install -r requirements.txt
```

### OTinstaller (Linux)

You can also install Blackbird with [OTinstaller](https://github.com/OSINTVerseHQ/OTinstaller), a third-party installer. Report install problems on [its issue tracker](https://github.com/OSINTVerseHQ/OTinstaller/issues).

```
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**

```bash
python blackbird.py --username johndoe
```

**Search by email**

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

**Export results to PDF**

```bash
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.

- No sensitive data is shared — only site names are sent

- Usage is completely free, with a fair daily limit

- AI results are also included in PDF exports (```--pdf```)
#### Generate an API key:
```bash
python blackbird.py --setup-ai
```
#### Use it
```bash
python blackbird.py --username johndoe --ai
```

## More
For more details about the project, visit the <a href="https://p1ngul1n0.gitbook.io/blackbird/">Docs</a>

### Project Developer

[Lucas Antoniaci](https://www.linkedin.com/in/lucas-antoniaci/)

### WhatsMyName

Blackbird is fully integrated with [WhatsMyName](https://github.com/WebBreacher/WhatsMyName) project, witch has 600+ sites to perform accurate reverse username search.

### Sponsors

[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%203.svg)](https://www.digitalocean.com/?refcode=eae02be1dd10&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=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.
```