Quickstart: install and solve your first challenge

Install Cloudsneak, start the FastAPI server, and send your first Turnstile solve request in under 5 minutes.

This quickstart installs Cloudsneak, starts the FastAPI service, and sends a Turnstile solve request against the local server.

Install

Install the package from source:

pip install .

Install the Playwright Chromium runtime that Cloudsneak drives:

playwright install chromium

Run the server

Launch the FastAPI service with the CLI:

cloudsneak --host 0.0.0.0 --port 8742

Or invoke the module directly:

python -m cloudsneak.cli

Solve your first challenge

Send a Turnstile solve request to the local server:

curl -X POST "http://localhost:8742/cloudflare" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "turnstile",
    "domain": "https://example.com",
    "siteKey": "0x4AAAAAAACk5342..."
  }'

The response returns the solved token and elapsed time. See Solve Cloudflare for the full request and response schema, including IUAM mode.