booru-backed procedurally-generated anime image captcha library and server
Captchouli scrapes boorus for admin-defined tags and generates and verifies captchas for user anti-bot authentication.
- Install OpenCV >= 2.4 development library (
libopencv-devon Debian-based systems)
- Install Go >= 1.10
go get github.com/bakape/captchouli/cmd/captchouli
- The captchouli server binary will be located under
$HOME/go/bin/captchouli, if the default
Captchouli can be used as either a library or standalone server.
captchouli --help for a list CLI flags.
After the server has been started and the inital tag pool populated captchouli can be accessed using a HTTP API:
|GET||/||Optional query parameters "captchouli-color" and "captchouli-background" for overriding the default captcha text colour and background||New captcha form HTML|
|POST||/||Form data from the user||Either the ID of the solved captcha on success or a redirect to a fresh captcha, if incorrectly solved|
|POST||/status||"captchouli-id" parameter - the ID of the captcha you wish to check the status of||"true", if captcha exists and has been solved or "false" otherwise. Note that this unregisters the captcha to prevent reply-again attacks.|