adrf

What it is and what it does

adrf is a compatibility layer that brings async/await syntax to Django REST framework, allowing you to write non-blocking request handlers in Django 4.1 and later. It provides async versions of core components—APIView, ViewSet, ModelViewSet, Serializer, and authentication/permission/throttle classes—so you can leverage Python's async ecosystem without abandoning the patterns you already use.

The package works by extending django and djangorestframework's standard classes to support async handler methods. When you use adrf's router instead of the default router, async CRUD actions on ModelViewSet are automatically mapped to routes. All handler methods in async class-based views must be declared async; function-based views decorated with adrf's @api_view must also be async. This is a migration path for teams running modern Django and wanting to handle I/O-bound operations without blocking the request thread.

Use it for

• Build REST APIs that handle database queries asynchronously using Django's async ORM methods.
• Implement async authentication, permission, or throttle classes that need to perform I/O without blocking.
• Migrate existing projects to async handlers incrementally by converting views and viewsets one at a time.
• Write async function-based views using the @api_view decorator for lightweight, non-blocking endpoints.
• Use async serializers to validate and transform data in non-blocking contexts.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

adrf on PyPI

Before you install

Low friction install with a pure-Python wheel. Actively maintained as of 2026-08-11 with recent activity. Depends on django, djangorestframework, and async-property—all stable, widely-used packages.

Requires Django 4.1+ and Python 3.8+; all handler methods in async class-based views must be declared async or Django will raise an exception.

License in practice

MIT license is permissive; you can use, modify, and distribute this package with minimal legal constraints, provided you retain the license notice.

Quickstart

pip install adrf

# Add to INSTALLED_APPS
INSTALLED_APPS = ['adrf', ...]

# Use async views
from adrf.views import APIView

class AsyncView(APIView):
    async def get(self, request):
        return {"message": "async response"}

Package facts

Evidence: adrf-0.1.14-py3-none-any.whl

Tags

More Dynamic Content packages

See also djangorestframework-yaml · djangorestframework · djangorestframework-role-filters · drf-rw-serializers · drf-orjson-renderer · djangorestframework-bulk · djangorestframework-xml · rest_condition · drf-dynamic-fields · djangorestframework-csv