django-admin-runner¶
django-admin-runner
Run Django management commands from the admin with auto-generated forms, pluggable task runners, and a unified execution log.
@register_command
Register any management command with a decorator. Add group labels, permissions, and model attachments.
Auto-generated forms
argparse arguments become Django form fields automatically. No manual form writing needed.
Widget customisation
Override widgets per-argument, supply a custom Form class, or use decorator-level overrides.
Built-in file fields
FileOrPathField (upload or server path), FileField, and ImageField out of the box.
Pluggable runners
Django Tasks (default), Celery, sync, or write your own for any queue backend.
Execution log
Every run stored as a CommandExecution with full audit trail and rich HTML results.
Permission control
Per-command: superuser-only, Django permission strings, or AND-combined lists.
Model attachment
Show a "Run" button on any model's admin change-list via models=[...].
Unfold support
Auto-detected. Uses Unfold templates and widgets when installed.
Quick navigation¶
- Installation — get set up in under a minute
- Quickstart — register and run your first command
- Decorator reference — all
@register_commandoptions - Runners — built-in and custom runners
- Execution context — rich output and ANSI support
- Hooks — run code before and after command execution
- Admin themes — plain Django admin and Unfold
- Examples — complete example projects