Skip to main content

A library for using text-based CAPTCHAs from

Project description


A Python library for using text-based CAPTCHAs from

Build Status PyPI Version GitHub License

This is a simple wrapper around the TextCaptcha API which is a service which provides text-based CAPTCHA questions which helps to prevent spam from robots.

This is designed to be implemented into a server-side application such as a Discord Bot, IRC, SMS, etc...

Note: The TextCaptcha API is only suitable for low traffic websites. For more than 5 requests per second, your usage will be rate limited.


Use pip to install on all systems:

pip install textcaptcha

Usage Example

This example will ask a CAPTCHA question and ask for an answer which is then checked against the actual answer.

import textcaptcha

# Create a captcha fetcher to fetch captcha questions from the API
fetcher = textcaptcha.CaptchaFetcher()
# Fetch a new captcha from the API
captcha = fetcher.fetch()

# Print the captcha question to the console
# Get a response from the user
answer = input("Answer: ")

# Check that the answer is correct
if captcha.check_answer(answer):
    print("You're not a robot!")
    print("You are a robot, sorry!")

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

textcaptcha-0.2.0.tar.gz (15.6 kB view hashes)

Uploaded Source

Built Distribution

textcaptcha-0.2.0-py3-none-any.whl (16.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