Metadata-Version: 2.4
Name: tilion-fortress
Version: 151.0.7908.0.post2
Summary: Install and drive the Fortress stealth Chromium engine. Prebuilt binary, no source.
Author: arham766
License: BSD-3-Clause
Project-URL: Homepage, https://github.com/tiliondev/fortress
Project-URL: Source, https://github.com/tiliondev/fortress
Keywords: chromium,stealth,browser,automation,anti-bot,fortress,tilion
Requires-Python: >=3.8
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/tiliondev/fortress/main/docs/assets/dockerhub-banner.png" width="100%" alt="Fortress — stealth Chromium engine">
</p>

<h1 align="center">tilion-fortress</h1>

<p align="center"><b>Drive the Fortress stealth Chromium engine with one line — no build, no Chromium source.</b></p>

<p align="center">
  <a href="https://pypi.org/project/tilion-fortress/"><img src="https://img.shields.io/pypi/v/tilion-fortress?logo=pypi&logoColor=white" alt="PyPI"></a>
  <a href="https://pypi.org/project/tilion-fortress/"><img src="https://img.shields.io/pypi/pyversions/tilion-fortress?logo=python&logoColor=white" alt="Python"></a>
  <a href="https://hub.docker.com/r/tilion/fortress"><img src="https://img.shields.io/docker/pulls/tilion/fortress?logo=docker&logoColor=white&label=docker%20pulls" alt="Docker Pulls"></a>
  <a href="https://github.com/tiliondev/fortress"><img src="https://img.shields.io/github/stars/tiliondev/fortress?style=social" alt="Stars"></a>
  <a href="https://github.com/tiliondev/fortress/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-BSD--3--Clause-blue" alt="License"></a>
</p>

---

**Stop getting blocked — without `puppeteer-stealth`.** JavaScript stealth patches self-reveal: a detector checks whether a getter is native code and catches the override. Fortress compiles the fingerprint correction into Chromium's **C++**, so a page inspecting itself sees stock Chrome. It clears **CreepJS**, **Sannysoft**, **BrowserScan**, and live **Cloudflare** as a normal Chrome install.

## Install

```bash
pip install tilion-fortress
```

On first use it downloads the prebuilt Fortress binary for your platform from the official GitHub Release (SHA-256 verified) and caches it. No Chromium source, no compilation.

## Quick start

```python
from tilion_fortress import Fortress
from playwright.sync_api import sync_playwright

with Fortress() as f:                                   # launches the stealth engine on a CDP endpoint
    with sync_playwright() as p:
        browser = p.chromium.connect_over_cdp(f.cdp_url)
        page = browser.new_page()
        page.goto("https://bot.sannysoft.com")
        page.screenshot(path="all-green.png")
```

Keep your existing Playwright / Puppeteer / CDP code — just point it at `f.cdp_url`. Works the same under **browser-use**, **Crawl4AI**, **Stagehand**, and **LangChain**.

## Verified against live detectors

| Suite | Result |
|---|---|
| **CreepJS** | 0% headless · 0% stealth |
| **bot.sannysoft.com** | 0 failed · all green · WebGL = NVIDIA RTX 3060 / ANGLE D3D11 |
| **browserscan.net** | "No bots detected, could be a human" |
| **rebrowser bot-detector** | no `Runtime.enable` leak · `webdriver=false` |
| **Cloudflare Turnstile** | cleared a live challenge |

## Custom persona

The default persona is a coherent Windows identity. Override any surface:

```python
Fortress(
    persona={"timezone": "America/Chicago", "languages": "en-GB,en",
             "hw_concurrency": 16, "webgl_renderer": "ANGLE (NVIDIA, RTX 3060 ...)"},
    extra_args=["--window-size=1280,800"],
)
```

## Platform support

Linux x64 has a native prebuilt binary. On macOS / Windows the package transparently runs Fortress via the official Docker image (`tilion/fortress`) — Docker is the cross-OS vehicle until native Win/Mac builds ship.

> **Still blocked?** ~90% of the time it's your **IP**, not your fingerprint — datacenter ranges are flagged before any page script runs. Route egress through a residential or mobile proxy and retry.

## Links

- **Source & docs:** https://github.com/tiliondev/fortress
- **Agent guide:** https://github.com/tiliondev/fortress/blob/main/AGENTS.md
- **Docker image:** https://hub.docker.com/r/tilion/fortress

BSD-3-Clause · reproducible from source · monthly Chromium rebase · **Blink · V8 · BoringSSL** patched in-tree.
