[{"_1":2,"_175":-5,"_176":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_150":151},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":11,"_17":11,"_18":19,"_20":11},"username","isBillingDecouplingSeatCount","isSearchBoxExperimentEnabled","isAskGordonEnabled",true,"isUsingNewTemplate","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_94":-5,"_95":96,"_143":-5,"_144":11,"_145":11,"_146":11,"_147":-5,"_148":149},"canonicalUrl","https://hub.docker.com/r/norkz/tenshi/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","norkz","reponame","tenshi","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_49":50,"_52":53,"_54":55,"_56":11,"_57":58,"_59":60,"_61":62,"_39":31,"_28":29,"_64":65,"_66":51,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":68,"_75":76,"_77":11,"_78":29,"_79":80,"_85":11,"_86":87,"_91":29,"_92":93},"categories",[38,43,46],{"_39":40,"_41":42},"name","Security","slug","security",{"_39":44,"_41":45},"Developer tools","developer-tools",{"_39":47,"_41":48},"Web servers","web-servers","content_types",[51],"image","date_registered","2025-04-16T00:45:02.091286Z","description","Bypasses Cloudflare Turnstile using OpenCV and browser automation.","is_private","last_updated","2025-04-20T05:10:14.385774Z","last_modified","2025-04-16T01:02:12.177371Z","media_types",[63],"application/vnd.docker.distribution.manifest.list.v2+json","pull_count",2420,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n $\"Tenshi\"$ \n

\n\n

\n Bypasses Cloudflare Turnstile using OpenCV and browser automation.\n

\n\n

\n \n \n $\"Contributions$ \n \n \n \n $\"Commits$ \n \n \n \n $\"License\"$ \n \n \n \n $\"Contributor$ \n \n \n \n $\"GitHub$ \n \n

\n\n## 🔍 Overview\n\nTenshi is a modular automation tool designed to bypass Cloudflare Turnstile anti-bot measures. It leverages computer vision (via OpenCV) and browser automation to navigate through Cloudflare Turnstile challenge seamlessly.\n\n## 🌐 Supported Environments\n\n- **Operating Systems**: Linux, macOS, and Windows (via Docker installation)\n- **Browser**: Brave Browser (with remote debugging enabled)\n- **Automation**: Combines xdotool, OpenCV, and FastAPI to control browser behavior\n- **Containerization**: Fully configured Docker environment for both development and production\n\n## 🚀 Installation\n\n### 🐳 Docker\n\n1. Ensure Docker is installed.\n2. Copy `.env.example` to `.env` and set your environment variables.\n3. Build and run the container:\n ```bash\n docker compose -f docker-compose.yml up -d --force-recreate\n ```\n\n## 💻 Usage\n\n### FastAPI Endpoints\n\nTenshi exposes a FastAPI server with several endpoints:\n\n- **Trigger Automation** \n **Endpoint:** `/trigger` \n **Description:** Loads the target URL in the browser, executes optional JavaScript, and initiates the Cloudflare bypass workflow. \n **Example (using curl):**\n\n ```bash\n curl \"http://localhost:6081/trigger?url=https://example.com&js=&wait=&sleep=5000\"\n ```\n\n- **Save Image** \n **Endpoint:** `/save_image` \n **Description:** Navigates to the chapter URL, processes the provided image URL, and invokes the browser save automation. \n **Example:**\n\n ```bash\n curl \"http://localhost:6081/save_image?chapter_url=https://example.com/chapter1&image_url=https://cdn.example.com/image1.jpg\"\n ```\n\n- **Get Saved Image** \n **Endpoint:** `/get_image` \n **Description:** Returns a list of saved image filenames for a specified chapter folder or a specific image if a filename is provided. \n **Example:**\n ```bash\n curl \"http://localhost:6081/get_image?chapter=chapter_1\"\n ```\n\n### Remote Debugging Integration\n\nTenshi is built to work with a remote debugging–enabled Brave browser. In Docker, Brave is launched with remote debugging (internally on port 9223, forwarded to 6082). This enables you to connect your preferred browser automation tools (for example, Chromedp, Puppeteer, or Playwright) to control browser actions programmatically. The included [`toongod_scrape_demo.go`](./example/toongod_scrape_demo.go) demonstrates how to:\n\n- Connect to the remote debugging endpoint (e.g. `http://:6082`)\n- Navigate pages and extract content\n- Trigger Cloudflare bypass actions via the FastAPI endpoints\n-\n\n### Automation Capabilities\n\nAfter bypassing the Cloudflare Turnstile challenge, Tenshi allows you to further automate your browser. By connecting to the remote debugging port, you can integrate with powerful automation libraries such as Chromedp, Puppeteer, Playwright, and others. This flexibility enables you to build customized scrapers or automation workflows that can interact with the browser directly once the initial bypass is complete.\n\n## 🤝 Contribution\n\nContributions, issues, and pull requests are welcome! Please refer to [CONTRIBUTING.md](CONTRIBUTING.md) for development and contribution guidelines.\n\n## 📈 Star History\n\n\n

\n\n","has_starred","hub_user","immutable_tags_settings",{"_81":11,"_82":83},"enabled","rules",[84],".*","is_automated","permissions",{"_88":19,"_89":11,"_90":11},"read","write","admin","user","storage_size",3561918908,"orgData","recentTags",[97],{"_98":51,"_99":100,"_101":102,"_103":104,"_105":106,"_107":108,"_57":131,"_132":100,"_133":29,"_134":63,"_39":135,"_136":137,"_138":139,"_140":131,"_141":72,"_142":19},"content_type","creator",15472620,"digest","sha256:06ae8725f9d3253eff376213ee930ba50a373a8fdc4fe8c0a62b0382bfa3ef9b","full_size",1022475126,"id",883925739,"images",[109,125],{"_110":111,"_101":112,"_113":114,"_115":116,"_117":118,"_119":120,"_121":114,"_122":-5,"_123":104,"_69":72,"_124":-5},"architecture","amd64","sha256:ce0ad21689c817e15a693c2cd767e0580028aec68c09c0dfb3df1d667b0b07b3","features","","last_pulled","2026-07-21T03:11:17.827035764Z","last_pushed","2025-04-20T05:10:11.708074077Z","os","linux","os_features","os_version","size","variant",{"_110":126,"_101":127,"_113":114,"_115":128,"_117":129,"_119":120,"_121":114,"_122":-5,"_123":130,"_69":72,"_124":-5},"arm64","sha256:afa01fb9c9574c1f4a2852941ea7a27ccd00d139dffcea1303eee8c1c6a3b754","2026-07-20T06:01:46.769886538Z","2025-04-20T05:10:12.298333301Z",939223394,"2025-04-20T05:10:13.245525Z","last_updater","last_updater_username","media_type","1.0.0","repository",27065584,"tag_last_pulled","2026-07-21T22:00:33.95395837Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":152,"_162":163,"_148":173,"_174":11},{"_36":153,"_49":157,"_52":53,"_54":55,"_56":11,"_57":58,"_59":60,"_61":158,"_39":31,"_28":29,"_64":65,"_66":51,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":68,"_75":76,"_77":11,"_78":29,"_79":159,"_85":11,"_86":161,"_91":29,"_92":93},[154,155,156],{"_39":40,"_41":42},{"_39":44,"_41":45},{"_39":47,"_41":48},[51],[63],{"_81":11,"_82":160},[84],{"_88":19,"_89":11,"_90":11},"tags",{"_164":70,"_165":-5,"_166":-5,"_167":168},"count","next","previous","results",[169],{"_98":51,"_99":100,"_101":102,"_103":104,"_105":106,"_107":170,"_57":131,"_132":100,"_133":29,"_134":63,"_39":135,"_136":137,"_138":139,"_140":131,"_141":72,"_142":19},[171,172],{"_110":111,"_101":112,"_113":114,"_115":116,"_117":118,"_119":120,"_121":114,"_122":-5,"_123":104,"_69":72,"_124":-5},{"_110":126,"_101":127,"_113":114,"_115":128,"_117":129,"_119":120,"_121":114,"_122":-5,"_123":130,"_69":72,"_124":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
ce0ad21689c8	linux/amd64	975.11 MB
afa01fb9c957	linux/arm64	895.71 MB

norkz/tenshi

Tags for norkz/tenshi