Skip to main content

CAPTCHA guide

Altcha

Self-hosted proof-of-work check: the browser does a bit of hashing, with no puzzle to solve.

Difficulty: Low
Open source
Exploded concept drawing of how the Altcha challenge is built

ALTCHA is an open-source CAPTCHA alternative that sites host themselves, designed around privacy. There is no picture to solve: it relies on proof-of-work (PoW), where the browser quietly computes a cryptographic challenge and sends back a signed payload. It deliberately does no tracking or fingerprinting, so getting past it simply means solving the PoW. No browser interaction is needed.

How to identifyLink to How to identify

  • An <altcha-widget> element, or the altcha.min.js / altcha.js script
  • An "I'm not a robot" checkbox that switches to "Verification successful" after a moment
  • A JSON challenge containing fields such as algorithm, challenge, salt, signature and maxnumber
  • A hidden form field called altcha holding a base64 payload
  • Calls to /altcha or another configured challenge endpoint
  • From v3, algorithm names like PBKDF2/SHA-256, SCRYPT or ARGON2ID

How it worksLink to How it works

  1. The server generates a challenge and signs it with an HMAC secret.
  2. A Web Worker in the widget solves the PoW using iterated hashing, PBKDF2, scrypt or Argon2id.
  3. The answer is bundled with the challenge and its signature into a base64 payload.
  4. That payload goes into the hidden altcha field and is submitted with the form.
  5. The server checks both the PoW and the signature. No third-party token service is involved.

Free bypass methodsLink to Free bypass methods

Method What it does Success Rate Link
altcha (official Python lib) Solves the challenge and assembles the payload ~100% (if cost is reasonable) altcha-org/altcha-lib-py
Official JS widget Runs the widget in Node or Playwright and reads the payload ~100% altcha-org/altcha
Custom solver Re-implements the SHA-256, PBKDF2, scrypt or Argon2id search ~100% (v1) hashlib
Playwright / DrissionPage Lets the page solve the PoW, then reads the hidden input ~100% g1879/DrissionPage
ddddocr Only useful for the optional image-code fallback 60-85% sml2h3/ddddocr

Python approach (official library)Link to Python approach (official library)

  1. Fetch the page or the challenge JSON and pull out the challenge object.
  2. Pass it to solve_challenge(challenge).
  3. Build the payload with Payload(challenge, solution).to_base64().
  4. Place it in the altcha form field and submit.
from altcha import solve_challenge, Payload

solution = solve_challenge(challenge)
payload = Payload(challenge, solution).to_base64()
data = {"altcha": payload}

Practical tipsLink to Practical tips

  • Solving time depends on the cost and maxnumber. Cheap challenges take milliseconds. Argon2id or scrypt can take seconds, which is still cheap next to a visual CAPTCHA.
  • The payload is signed, so changing any field invalidates it.
  • Some sites accept the payload only for a short time. Submit it quickly.
  • ALTCHA can fall back to an image code. OCR can read it, but the PoW route is simpler.
  • Every deployment is self-hosted, so there is no central service to target. One generic solver covers them all.

Skip the solver: let BrowserSolver handle Altcha

Website AntiBot runs a real browser session with matching TLS, headers, cookies and IP, clears the challenge, and returns the page. You send a URL, you get HTML back.

For education and authorized testing only. Respect the law, privacy, and the terms of the sites you work with. Difficulty labels are editorial estimates. Adapted from the CC0 community field guide on GitHub.