Web Bot Auth Python

Implementation of Web Bot Auth in Python.

Read the story behind Web Bot Auth, or find out more about how to Identify Bots with HTTP Message Signatures.

Installation

Install via uv

uv add bot-auth

or pip

pip install bot-auth

Development

Requirements

• Python 3.13
• uv - Python package manager

Build

To build bot-auth package

uv sync

uv build

Run examples

In the examples folder there are examples of how to use Bot Auth with popular scraping libraries like scrapy or crawl4ai.

Each example is a project, see the README in each example folder to run it.

cd examples/crawl4ai-hook
uv run main.py

Lint

This codebase uses ruff and Black for linting.

To run a check, use

uv run ruff check .
uv run black --check .

To format the codebase

uv run ruff format .
uv run black .

Security Considerations

This software has not been audited. Please use at your sole discretion.

License

This project is under the Apache 2.0 license.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be Apache 2.0 licensed as above, without any additional terms or conditions.