tfranzel/drf-spectacular

Health v2 · maintenance only

Adoption not part of the score

2857 stars · 329 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

drf-spectacular is a Python library that generates OpenAPI 3 (3.0, 3.1, and 3.2) schema specifications for Django REST framework APIs. It extracts as much schema information as possible from DRF serializers and views while offering extensive customization via decorators and hooks.

Use cases

• generate an OpenAPI 3 schema for a Django REST framework API
• serve Swagger UI or Redoc documentation for a DRF API
• customize API schema with request and response serializer overrides
• document polymorphic responses in a DRF API
• produce client-ready OpenAPI specs for code generators
• add authentication schemes like SimpleJWT or OAuth to API docs

When to choose

• you have a Django REST framework project and need accurate OpenAPI 3 documentation
• you want schema generation that handles nested, recursive, and polymorphic serializers
• you need fine-grained schema customization via decorators and hooks
• you want built-in Swagger UI and Redoc serving views

When to avoid

• your API is not built on Django REST framework
• you need OpenAPI 2.0 (Swagger 2) output instead of OpenAPI 3
• you use a non-Python web framework

Facets

library · maturity active

api-documentation documentation serialization middleware web-development backend apis documentation developer-tools python django django-rest-framework openapi3 swagger schema-generation rest-api api-docs web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="tfranzel/drf-spectacular")