NEXT-GEN DJANGO SCAFFOLDER

AJO CLI

Professional Django Scaffolder with Cyberpunk TUI

An interactive CLI tool that generates production-ready Django projects with a beautiful cyberpunk-themed terminal UI. Pick your architecture, database, and add-on modules — AJO handles the rest.

QUICK INSTALLATION

$ uv tool install ajo-cli

Python 3.10+

Django 5.0+

uv Powered

ajo@terminal: ~

MODULAR ARCHITECTURE

Architecture Presets

AJO generates clean, production-ready project structures tailored to your specific stack. Choose your foundation and layer features seamlessly.

monolith

Standard Monolith

Classic full-stack Django setup integrated with Bootstrap 5 and HTMX for dynamic, modern user interfaces without SPA complexity.

STACK: DJANGO + HTMX READY

rest-api

REST API Ready

Django REST Framework (DRF) foundation equipped with JWT authentication, CORS headers, and auto-generated Swagger/OpenAPI documentation.

STACK: DRF + JWT + SWAGGER MODEL-AWARE

ninja-api

Ninja API

High-performance, type-safe API structure using django-ninja and Pydantic. Features fast execution speeds and interactive Swagger UI.

STACK: NINJA + PYDANTIC MODEL-AWARE

graphql-api

GraphQL API

Modern GraphQL endpoint powered by Graphene and Relay. Includes pre-configured GraphiQL IDE for interactive query testing.

STACK: GRAPHENE + RELAY MODEL-AWARE

docker

Docker Stack

Multi-stage Dockerfile optimized with uv caching, paired with docker-compose.yml containing PostgreSQL, Redis, and Mailhog.

STACK: COMPOSE + REDIS + MAILHOG PRODUCTION

AST ANALYSIS

Model-Aware Scaffolding

AJO's API presets scan your Django models via AST analysis to auto-generate serializers, viewsets, routers, and endpoints instantly.

ZERO BOILERPLATE SMART ENGINE

Add-on Modules

Layer optional features on top of any preset. Select them interactively during scaffolding or pass them via CLI flags.

Auth & Users

auth

SimpleJWT authentication, custom User model with bio/avatar fields, registration/login templates, and preset-aware REST or Ninja endpoints.

Caching & Performance

cache

Redis caching integration via django-redis, database connection pooling, django-debug-toolbar, and demo cached views.

Security Hardening

security

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

Testing Infrastructure

testing

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

GETTING STARTED

Installation Guide

Install AJO using your preferred package manager. We recommend using isolated environments like uv or pipx.

# Recommended — isolated environment
pipx install ajo-cli

# With pip (global)
pip install ajo-cli

AJO DIAGNOSTIC ENGINE

SCANNER

TARGET: ./my_django_project READY TO SCAN

Check: Missing contrib apps in INSTALLED_APPS

Scans settings.py for standard Django apps

Check: Missing ALLOWED_HOSTS configuration

Verifies host validation settings

Check: Hardcoded DEBUG=True in production

Checks environment variable fallback

Check: Missing or placeholder SECRET_KEY

Validates cryptographic key strength

SELF-HEALING SYSTEM

Smart CLI & Diagnostics

AJO isn't just for scaffolding. Run ajo inside any existing Django project to unlock a context-aware management dashboard and self-healing diagnostic engine.

Live Project Dashboard

Displays real-time project metadata, active git branch, virtualenv status, server state, unapplied migrations, and Ruff lint status.

One-Click Auto-Fixes

Detects misconfigurations and offers instant, automated fixes like generating secure keys, wiring admin URLs, and renaming duplicate migrations.

Context-Aware Commands

Highlights urgent actions (like creating superusers or running migrations) based on the current state of your local database and codebase.