captchouli

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.

Installation

1. Install OpenCV >= 4.0 development library (libopencv-dev on Debian-based systems)
2. Install Go >= 1.10
3. Run go install github.com/bakape/captchouli/cmd/captchouli@latest
4. The captchouli server binary will be located under $HOME/go/bin/captchouli, if the default $GOPATH is used.

Usage

Captchouli can be used as either a library or standalone server.

Server

Run 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:

Method	Address	Receives	Returns
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.

Advanced use cases

For more advanced use cases please refer to the Go API documented here .