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 thealtcha.min.js/altcha.jsscript - 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,signatureandmaxnumber - A hidden form field called
altchaholding a base64 payload - Calls to
/altchaor another configured challenge endpoint - From v3, algorithm names like
PBKDF2/SHA-256,SCRYPTorARGON2ID
How it worksLink to How it works
- The server generates a challenge and signs it with an HMAC secret.
- A Web Worker in the widget solves the PoW using iterated hashing, PBKDF2, scrypt or Argon2id.
- The answer is bundled with the challenge and its signature into a base64 payload.
- That payload goes into the hidden
altchafield and is submitted with the form. - 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)
- Fetch the page or the challenge JSON and pull out the challenge object.
- Pass it to
solve_challenge(challenge). - Build the payload with
Payload(challenge, solution).to_base64(). - Place it in the
altchaform 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.