Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

autolycos

Anti-bot fetching subsystem: escalating Fetcher tiers (http to tls to browser to uc) behind a stable port, with fail-closed SSRF guards. Domain-agnostic by design: the caller injects a DomainPolicy, so the library carries no hardcoded allowlist.

Pre-release (0.1.0a1). The public API is not frozen yet and may change before the first stable release. Published mainly to reserve the name and validate the release pipeline. Not recommended for production use yet.

What it does

autolycos resolves access to bot-protected pages by escalating through increasingly capable (and costly) fetcher tiers, stopping at the first success:

  1. http -- plain HTTP with a pinned IP (SSRF-safe).
  2. tls -- TLS fingerprint impersonation (curl_cffi).
  3. browser -- undetected headless browser (patchright + playwright-stealth).
  4. uc -- undetected Chrome driver (seleniumbase) for the hardest protectors.

Access selection is a separate concern (the Router) from the tools (the adapters). SSRF safety is enforced fail-closed at both the config-mutation gate and the fetch gate via a single shared predicate.

Stable contract (consumer-facing)

  • autolycos.ports: Fetcher, FetchResult, Router
  • autolycos.safety: DomainPolicy, check_scheme_and_domain
  • autolycos.errors: SSRFError, FetchError
  • autolycos.router: StaticRouter

Install

pip install autolycos                 # core (http tier)
pip install "autolycos[tls]"          # + TLS impersonation
pip install "autolycos[browser]"      # + undetected browser
pip install "autolycos[uc]"           # + undetected Chrome driver

License

Apache-2.0. See LICENSE.

Metadata

Release files for autolycos 0.1.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for autolycos 0.1.0a1
File Size Uploaded Provenance
autolycos-0.1.0a1.tar.gz 24.0 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for autolycos 0.1.0a1
File Interpreter ABI Platform
autolycos-0.1.0a1-py3-none-any.whl Python 3 none any Details

Total release size: 58.0 kB

Release files / autolycos-0.1.0a1.tar.gz

Download URL autolycos-0.1.0a1.tar.gz
Size 24.0 kB
Tags Source
SHA-256 checksum
How to use checksums
978c246092f3620a1896e2c3c3beae18c034b72b3cbe4d3c1c3e2e621d710d49
BLAKE2b-256 checksum
How to use checksums
dfd4eb68b17b60fe52b67dd775ed4f3d0e871a13935c8900158fb5a243b2a191
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.

Transparency log

Release files / autolycos-0.1.0a1-py3-none-any.whl

Download URL autolycos-0.1.0a1-py3-none-any.whl
Size 34.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
db2f28135efe611e3a25b412f1935bc7c9acef371d13bbc4a6a6b93827baeabb
BLAKE2b-256 checksum
How to use checksums
3411d53ac29aa570f45f6ece08bc891ebd40f944c1648a899280cfbcbef31439
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.

Transparency log

Security for autolycos 0.1.0a1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for autolycos-0.1.0a1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page