Skip to main content

An easy generator of Captcha for Discord bots, creating embeds and images.

Project description


DisCaPty is a Python module to generate Captcha challenge more easily and with more flexibility. Principally made for Discord bot developers but available for everyone!

PyPI PyPI - Python Version PyPI - Downloads


DisCaPty is available on PyPi!

python -m pip install -U discapty

You can also clone the module using git:

python -m pip install -U git+

It is still recommended to use PyPi.

Creating Captcha

DisCapTy include 3 differents types of Captcha style.

  • text: A Captcha that use plain text. This type is particular as it include a zero width space character between each letter/number to unallow the user to copy/paste the captcha.
  • wheezy: An image Captcha, pretty basic and easy to read. Configurable
  • image: An image Captcha, a bit more hard to read, less user friendly. Configurable.

You can choose which type to use when creating a Captcha object.


import discapty

captcha = discapty.Captcha("wheezy")
# You are initializing a Captcha object that is the "wheezy" type.
# If you want to show the image/captcha, use generate_captcha()
captcha_image = captcha.generate_captcha() # <_io.BytesIO object at XxXXX>

However, using the "text" type will not return a BytesIO object but a string.

import discapty

captcha = discapty.Captcha("text")
captcha_image = captcha.generate_captcha() # This will return a string, not a BytesIO object.

You can also easily create an embed.

import discapty

async def send_captcha(ctx):
    captcha = discapty.Captcha("image")
    captcha_image = discord.File(captcha.generate_captcha(), filename="captcha.png") # This is # # important to put this filename, otherwise Discord will send the image outside of the embed.
    # You can change it when generating the embed. 
    captcha_embed = captcha.generate_embed(
    await, file=captcha_image)

Create more complex Captcha

The power of DisCapTy is how it let you customize your Captcha by using the setup function. When using this function, it is recommended to use number that are reasonable enough to not overload your machine. Image creation may take time if you abuse of it, and memory can also go high.

import discapty

def generate_captcha():
    captcha = discapty.Captcha("wheezy")

    # This function is what allow developers to set addition settings for their captcha, refer to the function's help for more parameters to use.
    captcha.setup(width=400, height=400, noise_color="#FF0000")

    return discapty.generate_embed() # Return the image with the settings that has been set.


You can join my Discord server for any help:

DisCapTy is licensied under MIT: PyPI - License DisCapTy use the Roboto font as default font. This font is licensied under Apache-2.0.

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

DisCapTy-1.0.3.tar.gz (102.5 kB view hashes)

Uploaded source

Built Distribution

DisCapTy-1.0.3-py3-none-any.whl (102.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page