ajo v3.4.0
Django scaffolder · v3.4.0

Stop configuring Django.
Start shipping it.

AJO scaffolds production-ready Django projects in seconds — pick a preset, layer add-ons, and walk away with a repo you can deploy today.

Quick install
$ uv tool install ajo-cli
GitHub stars
GitHub forks
PyPI downloads per month
Built daily
Python 3.10+ Django 5.0+ uv powered
ajo@cli — scaffold
Architecture presets

Pick a foundation. Layer the rest.

Six preset architectures, each production-ready and zero-config. Mix and match with add-on modules — AJO handles the wiring.

monolith

Standard Monolith

Classic full-stack Django with Bootstrap 5 and HTMX — modern interactivity without SPA complexity.

Django + HTMX Ready
rest-api

REST API Ready

Django REST Framework foundation with JWT auth, CORS, and auto-generated Swagger/OpenAPI docs.

DRF + JWT + Swagger Model-aware
ninja-api

Ninja API

Type-safe, high-throughput API with django-ninja + Pydantic and interactive Swagger UI.

Ninja + Pydantic Model-aware
graphql-api

GraphQL API

Modern GraphQL endpoint using Graphene + Relay, with GraphiQL IDE pre-wired for query testing.

Graphene + Relay Model-aware
docker

Docker Stack

Multi-stage Dockerfile with uv caching and a compose file that ships Postgres, Redis, and Mailhog.

Compose + Redis + Mailhog Production
AST engine

Model-Aware Scaffolding

AJO inspects your Django models via AST and auto-generates serializers, viewsets, routers, and endpoints. Zero boilerplate.

Zero boilerplate Smart engine

Add-on modules

Optional features that slot into any preset — pick them interactively or via CLI flags.

Auth & Users

--auth

SimpleJWT auth, custom User model with avatar and bio fields, registration/login templates, and preset-aware endpoints.

Caching & Performance

--cache

Redis via django-redis, connection pooling, django-debug-toolbar, and demo cached views to compare.

Security Hardening

--security

Brute-force protection via django-axes, TOTP 2FA, CSP headers, and HSTS/XSS/CSRF hardening.

Testing Infrastructure

--testing

pytest + pytest-django, coverage (fail-under 80%), factory-boy, and auto-generated model factories + API tests.

Getting started

Install once. Scaffold forever.

Pick your favorite package manager. We recommend isolated environments — uv or pipx.

uv — install ajo-cli 

        

      

    


    
    

      

        
          Self-healing
        
        
Smart CLI & diagnostics

        

          AJO isn’t just for scaffolding. Run ajo inside any existing Django project to unlock a context-aware dashboard and one-click fixes.
        

      


      


        
        

          

            

              

                
                
                
              

              

                
                AJO diagnostic engine
              

              SCANNER
            


            

              

                TARGET · ./my_django_project
                READY TO SCAN
              


              


              

                ajo doctor ./my_django_project
                
              

            

          

        


        
        

          

            

            

              
Live project dashboard

              

                Real-time project metadata — git branch, virtualenv, server state, pending migrations, Ruff lint status.
              

            

          


          

            

            

              
One-click auto-fixes

              

                Detects misconfigurations and resolves them instantly — secure keys, admin URLs, duplicate migrations, more.
              

            

          


          

            

            

              
Context-aware commands

              

                Surfaces urgent actions — create a superuser, run migrations — based on the actual state of your local database.