Metadata-Version: 2.4
Name: aura-fetch
Version: 1.0.0
Summary: An ultimate, lightning-fast image fetcher that bypasses Cloudflare and anti-bot servers.
Author: Your Name
Author-email: your.email@example.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: DrissionPage>=4.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 📸 Aura Image Fetcher (`aura-image-fetcher`)

**Aura Image Fetcher** is an insanely fast, anti-bot-bypassing Python library designed specifically to download and fetch images from **any** URL, completely ignoring Cloudflare, referer protections, and firewall blocks.

It achieves speeds of **fractions of a second** by keeping a totally invisible (headless) Native Chromium engine running in the background. When an image is requested, it directly extracts the raw image bytes from the browser's memory via HTML5 Canvas, bypassing Python's network stack entirely to evade ISP blocks, Antivirus MITM, and Cloudflare!

## 🚀 Key Features
- **Extreme Speed:** Downloads images in fractions of a second.
- **Bypass Cloudflare & ISP Blocks:** Uses a real browser engine natively, so your ISP or Antivirus cannot intercept and drop the connection like they do with `requests` or `curl`.
- **All Formats Supported:** Extracts PNG, JPG, WEBP, AVIF, and more directly from memory.
- **Auto-Hotlink Bypass:** Bypasses hotlink protections naturally.

## 📦 Installation

```bash
pip install aura-image-fetcher
```

## 💻 Usage

```python
from aura_image_fetcher import AuraImageFetcher

# Initialize the fetcher (set debug=True to see the magic happening)
fetcher = AuraImageFetcher(debug=True)

# 1. Save an image directly to your disk
success = fetcher.save_image(
    image_url="https://example.com/protected_image.jpg",
    save_path="my_images/test.jpg"
)

# 2. Or, fetch the raw image bytes to process in memory (e.g., for AI Vision models)
image_bytes = fetcher.fetch_image("https://example.com/protected_image.jpg")
if image_bytes:
    print(f"Downloaded {len(image_bytes)} bytes!")
```

## 🧠 Why is it so formidable?
Most image servers block bots by checking the TLS fingerprint or checking if the request came from their own website. `AuraImageFetcher` intelligently reconstructs a perfect Chrome header and dynamically spoofs the origin website, forcing the server to surrender the image immediately!
