December 15, 2020

292 words 2 mins read



Fast, Async-ready, Openapi, type hints based framework for building APIs

repo name vitalik/django-ninja
repo link
language Python
size (curr.) 1480 kB
stars (curr.) 463
created 2020-05-19
license MIT License

Test Coverage PyPI version

Django Ninja - Fast Django REST Framework

Django Ninja is a web framework for building APIs with Django and Python 3.6+ based type hints.

Key features

  • Easy: Designed to be easy to use and intuitive.
  • Fast: Very high performance thanks to Pydantic and async support.
  • Fast to code: Type hints and automatic docs let’s you focus only on business logic.
  • Standards-based: Based on the open standards for APIs: OpenAPI (previously known as Swagger) and JSON Schema.
  • Django friendly: (obviously) have good integration with Django core an ORM.
  • Production ready: Used by multiple companies on live projects (If you use django-ninja and would like to publish your feedback - please email to

Django Ninja REST Framework



pip install django-ninja


In your django project next to create new file:

from ninja import NinjaAPI

api = NinjaAPI()

def add(request, a: int, b: int):
    return {"result": a + b}

Now go to and add the following:

from .api import api

urlpatterns = [
    path("api/", api.urls),  # <---------- !

That’s it !

And you already have:

  • API that receives HTTP GET request at /api/add
  • Takes, validates and type-casts GET parameters a and b
  • Decodes to JSON operation result
  • Generates an OpenAPI schema for defined operation

Interactive API docs

Now go to

You will see the automatic interactive API documentation (provided by Swagger UI):

Swagger UI


comments powered by Disqus