CleanTalk ruby-antispam: Hassle-Free Spam Filtering for Ruby Apps — No CAPTCHA, No Clicks, Just Works

Powerful spam protection and reliable spam bot detection for Ruby applications — all in one gem.
CleanTalk is a convenient CAPTCHA/reCAPTCHA alternative offering intelligent cloud-based spam protection for forms, comments, and user registrations.
No CAPTCHA needed — just real-time bot filtering and smooth integration with Ruby forms.

Key features:

• Real-time Spam & Bot Protection
• Automatic Email Validation to eliminate fake or erroneous registrations
• Personalized Blocklists by IP, email, and country
• Custom Stop Words for fine-tuned spam filtering
• Easy and seamless integration
• Enjoy comprehensive spam protection and hassle-free user experience—no CAPTCHA/reCAPTCHA needed.

If you find this project useful, please consider starring ⭐ it on GitHub — it helps us grow and support development!

Install

Install via bundler

gem 'cleantalk'

For improve protection include javascript to your layout before tag:

<scripttype="text/javascript" src="https://fd.cleantalk.org/ct-bot-detector-wrapper.js"></script>

Usage

require'cleantalk'# Create a check_newuser requestrequest=Cleantalk::CheckNewuser.new({auth_key: 'ur_api_key',sender_email: 'test@example.org'})# Can initialize with valuesrequest.sender_ip='127.0.0.1'# and also mutate object directlyrequest.sender_nickname='test nickname'request.allowed?# => true or falserequest.result# => <Object Cleantalk::CheckNewuserResult> with all response data# Create a check_message requestrequest=Cleantalk::CheckMessage.new({auth_key: 'ur_api_key',sender_email: 'test@example.org',sender_ip: '127.0.0.1',sender_nickname: 'test nickname',})# Can initialize with valuesrequest.message='<p>Hello World!</p>'# and also mutate object directlyrequest.allowed?# => true or falserequest.result# => <Object Cleantalk::CheckMessageResult> with all response data# You can also pass auth_key has global configuration (still overridable by passing auth_key to request):Cleantalk.auth_key='ur_api_key'# Create a legacy request instancerequest=Cleantalk::Request.newrequest.auth_key='your_key'request.message='test message'# don't use this field for registration checkrequest.sender_email='stop_email@example.com'request.sender_nickname='test nickname'request.sender_ip='127.0.0.1'request.sender_info={cms_lang: 'en_US'}# here put locale for your language# In case use js bot detector, add event_token from your form for check frontend data# request.event_token = 'xxx' # fill it with ct_bot_detector_event_token hidden input from your form (auto generate)cleantalk=Cleantalk.newresult=cleantalk.is_allowed_message(request)# for message checkingresult=cleantalk.is_allowed_user(request)# for registration checking# result['allow'] contains our decision: 1 for allowed message, 0 for blocked# result['comment'] contains comment for our decision

Requirements

• CleanTalk account https://cleantalk.org/register?product=anti-spam

Websites that trust CleanTalk!