Skip to content

Commit 0a2cc82

Browse files
committed
Add agent quick-access badges and llms.txt
1 parent 6cc912e commit 0a2cc82

2 files changed

Lines changed: 25 additions & 0 deletions

File tree

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,8 @@ Stealth Chromium engine
2020
[![License](https://img.shields.io/badge/license-BSD--3--Clause-blue)](LICENSE)
2121
[![Stars](https://img.shields.io/github/stars/tiliondev/fortress?style=social)](https://github.com/tiliondev/fortress/stargazers)
2222

23+
[![Ask ChatGPT](https://img.shields.io/badge/Ask-ChatGPT-10A37F?logo=openai&logoColor=white)](https://chatgpt.com/?q=Help%20me%20set%20up%20Fortress%2C%20an%20open-source%20stealth%20Chromium%20engine%2C%20for%20my%20browser%20automation.%20First%20read%20the%20setup%20guide%20at%20https%3A%2F%2Fgithub.qkg1.top%2Ftiliondev%2Ffortress%2Fblob%2Fmain%2FAGENTS.md%20then%20walk%20me%20through%3A%201%29%20launching%20Fortress%20%28Docker%3A%20docker%20run%20-d%20--rm%20-p%209222%3A9222%20tilion%2Ffortress%3Alatest%2C%20or%20pip%2Fnpm%20install%20tilion-fortress%29%2C%202%29%20connecting%20my%20Playwright%20or%20Puppeteer%20code%20over%20CDP%20to%20http%3A%2F%2Flocalhost%3A9222%2C%203%29%20keeping%20my%20existing%20automation%20logic.%20Do%20NOT%20add%20puppeteer-stealth%20or%20JS%20fingerprint%20patches%20%E2%80%94%20Fortress%20spoofs%20the%20fingerprint%20in%20the%20engine%27s%20C%2B%2B.) [![Ask Claude](https://img.shields.io/badge/Ask-Claude-D97757?logo=claude&logoColor=white)](https://claude.ai/new?q=Help%20me%20set%20up%20Fortress%2C%20an%20open-source%20stealth%20Chromium%20engine%2C%20for%20my%20browser%20automation.%20First%20read%20the%20setup%20guide%20at%20https%3A%2F%2Fgithub.qkg1.top%2Ftiliondev%2Ffortress%2Fblob%2Fmain%2FAGENTS.md%20then%20walk%20me%20through%3A%201%29%20launching%20Fortress%20%28Docker%3A%20docker%20run%20-d%20--rm%20-p%209222%3A9222%20tilion%2Ffortress%3Alatest%2C%20or%20pip%2Fnpm%20install%20tilion-fortress%29%2C%202%29%20connecting%20my%20Playwright%20or%20Puppeteer%20code%20over%20CDP%20to%20http%3A%2F%2Flocalhost%3A9222%2C%203%29%20keeping%20my%20existing%20automation%20logic.%20Do%20NOT%20add%20puppeteer-stealth%20or%20JS%20fingerprint%20patches%20%E2%80%94%20Fortress%20spoofs%20the%20fingerprint%20in%20the%20engine%27s%20C%2B%2B.) [![Ask Gemini](https://img.shields.io/badge/Ask-Gemini-1C69FF?logo=googlegemini&logoColor=white)](https://gemini.google.com/app?q=Help%20me%20set%20up%20Fortress%2C%20an%20open-source%20stealth%20Chromium%20engine%2C%20for%20my%20browser%20automation.%20First%20read%20the%20setup%20guide%20at%20https%3A%2F%2Fgithub.qkg1.top%2Ftiliondev%2Ffortress%2Fblob%2Fmain%2FAGENTS.md%20then%20walk%20me%20through%3A%201%29%20launching%20Fortress%20%28Docker%3A%20docker%20run%20-d%20--rm%20-p%209222%3A9222%20tilion%2Ffortress%3Alatest%2C%20or%20pip%2Fnpm%20install%20tilion-fortress%29%2C%202%29%20connecting%20my%20Playwright%20or%20Puppeteer%20code%20over%20CDP%20to%20http%3A%2F%2Flocalhost%3A9222%2C%203%29%20keeping%20my%20existing%20automation%20logic.%20Do%20NOT%20add%20puppeteer-stealth%20or%20JS%20fingerprint%20patches%20%E2%80%94%20Fortress%20spoofs%20the%20fingerprint%20in%20the%20engine%27s%20C%2B%2B.) [![Copy for agent](https://img.shields.io/badge/Copy%20for%20agent-24292f?logo=readme&logoColor=white)](https://raw.githubusercontent.com/tiliondev/fortress/main/AGENTS.md) [![llms.txt](https://img.shields.io/badge/llms.txt-24292f?logo=readme&logoColor=white)](https://raw.githubusercontent.com/tiliondev/fortress/main/llms.txt)
24+
2325
<table align="center"><tr>
2426
<td align="center" width="150"><h3>34</h3><sub>single-surface<br/>C++ patches</sub></td>
2527
<td align="center" width="150"><h3>0%</h3><sub>CreepJS<br/>headless / stealth</sub></td>

llms.txt

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Fortress
2+
3+
> Fortress is an open-source stealth Chromium engine. It corrects the browser fingerprint (canvas, WebGL, audio, fonts, navigator, and ~30 more surfaces) in Chromium's C++ and exposes raw CDP on http://localhost:9222, so scrapers and browser agents pass bot detection. It is a drop-in for Playwright and Puppeteer: keep your automation code, point it at Fortress over CDP.
4+
5+
Rules for agents:
6+
- Do NOT add puppeteer-stealth, undetected-chromedriver, or any JavaScript fingerprint patching. Those self-reveal and undo Fortress; the spoofing already lives in the engine's C++.
7+
- Fortress hardens the browser fingerprint only. IP reputation and behavior are still the caller's responsibility.
8+
9+
## Launch (pick one; all expose CDP on http://localhost:9222)
10+
- Docker: `docker run -d --rm -p 9222:9222 tilion/fortress:latest`
11+
- Python: `pip install tilion-fortress` then `from tilion_fortress import Fortress; f=Fortress(); f.start()`
12+
- Node: `npm install tilion-fortress` then `import {Fortress} from "tilion-fortress"; const f=await Fortress.launch()`
13+
14+
## Connect (keep your existing automation code)
15+
- Playwright (Python): `p.chromium.connect_over_cdp("http://localhost:9222")`
16+
- Playwright (Node): `chromium.connectOverCDP("http://localhost:9222")`
17+
- Puppeteer (Node): `puppeteer.connect({ browserURL: "http://localhost:9222" })`
18+
- browser-use / Crawl4AI / Stagehand / LangChain: point the CDP endpoint at http://localhost:9222
19+
20+
## Docs
21+
- [AGENTS.md](https://github.com/tiliondev/fortress/blob/main/AGENTS.md): full paste-ready agent setup guide
22+
- [README](https://github.com/tiliondev/fortress/blob/main/README.md): overview, install, comparison, detection results
23+
- [Source](https://github.com/tiliondev/fortress): repo; packages `tilion-fortress` (PyPI/npm), Docker image `tilion/fortress`

0 commit comments

Comments
 (0)