django-smart-ratelimit 2.2.0

A flexible and efficient rate limiting library for Django applications

Django Smart Ratelimit

The checkmate for abusive traffic.

A high-performance, stateless rate limiting library for Django that protects your API from abuse, optimized for distributed systems with atomic Redis operations and circuit breaking.

Sponsors

Support the ongoing development of Django Smart Ratelimit!

Become a sponsor to see your logo here!

Key Features

• 🚀 Stateless & Modern: Dual-mode support (Sync/Async) without database dependencies.
• 🛡️ Enterprise Reliability: Built-in Circuit Breaker and Automatic Failover strategies.
• ⚡ Multiple Algorithms: Choose between Token Bucket, Sliding Window, and Fixed Window.
• 🔌 Flexible Backends: Redis (recommended), Async Redis, Memory, or Custom backends.
• 🎯 Precise Control: Rate limit by IP, User, Header, or any custom callable.

Quick Start

Installation

pip install django-smart-ratelimit[redis]

Usage in 30 Seconds

from django_smart_ratelimit import ratelimit

@ratelimit(key='ip', rate='5/m', block=True)
def login_view(request):
    # If limit is exceeded, this code receives a 429 Too Many Requests
    return authenticate(request)

Documentation

We have moved our detailed documentation to the dedicated docs/ folder:

Topic	Description
📚 Full Documentation	Start here for the complete guide.
🚀 Migration Guide	Upgrading from django-ratelimit? clear steps here.
🧮 Algorithms	Deep dive into Token Buckets and Windows.
⚙️ Configuration	Advanced settings, Backends, and Circuit Breakers.
🔍 Design Philosophy	Why we built this and how it compares to others.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on how to submit pull requests, report issues, and setup your development environment.

Community & Support

• GitHub Discussions: Ask questions and share ideas.
• Issues: Report bugs.
• AI Usage Policy: Our transparency commitment.

License

This project is licensed under the MIT License - see the LICENSE file for details.