Installation Guide

Requirements

  • Python 3.11+

  • One HTTP backend: aiohttp (recommended) or httpx

  • POSIX for optional uvloop (not available on Windows)

Install with an HTTP backend

aioscraper ships without an HTTP client. Pick one of the extras so requests work out of the box:

# Option 1: Use aiohttp with speedups (recommended for most cases)
pip install "aioscraper[aiohttp-speedups]"

# Option 2: Use aiohttp without speedups (minimal dependencies)
pip install "aioscraper[aiohttp]"

# Option 3: Use httpx (if you prefer httpx ecosystem)
pip install "aioscraper[httpx]"

# Option 4: Install both backends for flexibility
pip install "aioscraper[aiohttp-speedups,httpx]"

At runtime aioscraper will use aiohttp when available, otherwise it falls back to httpx.

You can explicitly set the backend by setting the SESSION_HTTP_BACKEND environment variable to aiohttp or httpx.

Optional: install with uvloop (POSIX)

uvloop can speed up event loop operations on Linux/macOS:

pip install "aioscraper[uvloop]"

If you plan to use --uvloop in the CLI, install this extra on supported platforms.

Next steps

  • Follow Quickstart for your first scraper.

  • See CLI for running via the command line (including --uvloop).