bbot

library2.8.6pypypi✓ verified 84d ago

BBOT (Bighorn Buster OSINT Tool) is an OSINT automation framework for hackers and security researchers, combining subdomain enumeration, port scanning, web screenshots, and more into a single modular pipeline. Current version: 2.8.4. Released regularly (multiple minor versions per month) on PyPI.

devops http-networking observability

pip install bbot

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · BBOT

bbot

devopspythonv2.8.6

Install

16.4s avg

Import

2428ms

Disk

159MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.8.6 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 2.508s · 157.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 16.4s · import 2.348s · 154MB

159MB installed

● package 159MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

scan

✓ from bbot.scanner import scanner

✗ from bbot import scan

The main entry point is the `scanner` class in `bbot.scanner` module, not a top-level `scan` function.

Scanner

✓ from bbot.scanner import Scanner

✗ from bbot import Scanner

Scanner is not exposed at package level; must import from submodule.

Initialize the BBOT scanner with target domain, enable subdomain enumeration and port scan, output to CSV, and run.

from bbot.scanner import scanner s = scanner("example.com", modules=["subdomain-enum", "portscan"], output_modules=["csv"], config={"modules": {"portscan": {"ports": [80, 443]}}}) s.start() results = s.json print(results[:2])

bbot --version

Debug

Known issues

breakingBBOT 2.x introduced a completely rewritten API. Old scripts using `from bbot import scan` or `BBot()` will fail. The new entry point is `bbot.scanner.scanner`.

fix

Update imports to `from bbot.scanner import scanner` and use `scanner()` function.

affects: >=2.0.0

gotchaDo not call `scanner()` with the same target more than once in the same process; BBOT reuses state and may produce unexpected results. Create a new scanner instance for each scan.

fix

Always instantiate a new scanner object per scan, e.g., `s = scanner(target)`.

affects: all

gotchaSome modules require external tools (e.g., nuclei, ffuf) to be installed separately. BBOT will not warn if they are missing; scans may silently skip those steps.

fix

Check the documentation for module prerequisites and ensure required tools are in your PATH.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'bbot'

BBOT is not installed or is installed in a different environment.

fix

Run `pip install bbot` in the correct Python environment.

AttributeError: module 'bbot' has no attribute 'Scanner'

Importing Scanner from the top-level `bbot` package instead of the submodule.

fix

Use `from bbot.scanner import Scanner` instead of `from bbot import Scanner`.

ValueError: Scanner cannot be started twice with same target

Attempting to call `start()` on the same scanner instance more than once.

fix

Create a new scanner instance for each scan: `s = scanner(target); s.start()`.

Upgrade

Version history

2.8.6latest on PyPI · released Jun 17, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

29 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/blacklanternsecurity/bbot ↗

packagehttps://pypi.org/project/bbot/ ↗

docshttps://www.blacklanternsecurity.com/bbot/ ↗