wtf is djo?

djo is a Python library that adds automatic interactive API documentation to a Django project. If you have used FastAPI's built in Swagger UI and wished Django had something similar without extra work, this is that tool. The setup is minimal. You add one entry, "djo", to the INSTALLED_APPS list in your Django settings file, and that is it. No changes to your urls.py file, no serializers to write, no decorators to add to your views. Once installed, visiting /docs on your running project shows a full interactive documentation page generated straight from your existing URL patterns. Under the hood, djo walks through your project's URL patterns and views to figure out what each endpoint expects and returns. It reads typed path parameters like integers, UUIDs, and slugs and maps them to the correct types automatically. It also looks at how your view code reads query parameters and request data to guess at the fields your API uses, and if you use Django REST Framework serializers, it reads the real field definitions directly from those instead of guessing. It can detect authentication and permission requirements on your views and shows an Authorize button in the documentation UI so you can test protected endpoints. Error responses like 404s or other status codes referenced in your code are also picked up and added to the documentation. The documentation page is interactive, meaning you can click Try It Out and send real requests against your actual running server, with session authentication and CSRF tokens handled automatically. djo requires Python 3.10 or newer and Django 5.2 or newer, and installs with a single pip command. It has no other required dependencies, meaning it works with plain Django projects and does not require Django REST Framework, though it will use DRF serializer information when it finds it. Configuration is optional, with settings available to customize the title, version, description, and URL paths for the documentation if the defaults do not fit your project.