Skip to content
Sepehr0Day edited this page Jun 13, 2026 · 1 revision

FAQ

Why is gTTS installed but AudioCaptcha cannot import it?

Install it into the same interpreter used to run the script:

python -m pip install "CaptchaGenerator[audio]"
python your_script.py

Can I use custom backgrounds?

Yes. Text generators accept backgrounds. Slider and irregular puzzles accept an image_path. Render hooks can modify every visual challenge.

Can I reproduce a challenge?

Set CaptchaConfig(random_seed=...). Do not use predictable seeds for public production challenges.

Does the library verify answers automatically?

It returns expected answers and UI metadata. Your application owns storage, expiry, rate limits and server-side verification.

Are answers safe inside metadata?

No. include_answer_in_metadata=True is for trusted debugging only.

Is a resource pack required?

No. Version 2.0 does not provide or require the legacy resource pack.

Where are runnable examples?

Each generator has simple.py and interactive.py under Examples/CaptchaExamples/<CaptchaName>/.

Clone this wiki locally