Skip to main content

Custom WTForms field that handles hCaptcha display and validation.

Project description

WTForms hCaptcha

Custom WTForms field that handles hCaptcha display and validation.

Build Status PyPI Version GitHub License

hCaptcha is a CAPTCHA service that 'protects user privacy, rewards websites, and helps companies get their data labelled'. This helps to prevent spam on websites by adding a challenge to forms that are hard for computers to solve, but easy for humans to solve.

I wanted to use hCaptcha in one of my projects and although there are already Python libraries for working with hCaptcha, I had already used the WTForms ecosystem in that project so I wanted a drop in solution and as there were none at the time, I decided to create my own.

This is a modified version of wtforms-recaptcha by Artem Gluvchynsky to work with hCaptcha.


Use pip to install on all systems:

pip install wtforms-hcaptcha

Usage Example

This example creates an empty form with just a CAPTCHA field.

from wtforms.form import Form
from wtforms_hcaptcha import HcaptchaField

class MyForm(Form):
    captcha = HcaptchaField(site_key="YOUR_SITE_KEY_HERE", secret_key="YOUR_SECRET_KEY_HERE")

form = MyForm(request.form, captcha={
    # note this needs to be edited to get the correct IP address when using a reverse proxy
    "ip_address": request.remote_addr

if form.validate():
    print("You are not a robot!")

Development Setup

This project uses Poetry to manage dependencies and packaging. Here are the installation instructions for Poetry.


  1. Fork it (
  2. Create your feature branch (git checkout -b feature/foobar)
  3. Commit your changes (git commit -am "Add some foobar")
  4. Push to the branch (git push origin feature/foobar)
  5. Create a new pull request

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wtforms-hcaptcha-0.1.3.tar.gz (16.5 kB view hashes)

Uploaded Source

Built Distribution

wtforms_hcaptcha-0.1.3-py3-none-any.whl (17.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page