django-easy-audit

What it is and what it does

django-easy-audit is a Django app that automatically captures and stores audit logs of model changes, user authentication events, and HTTP requests without requiring modifications to your existing model code. It uses Django signals to intercept create, update, and delete operations on all models in your project, then stores them in dedicated database tables that are queryable through the Django admin interface.

The package is designed as a low-friction alternative to other audit solutions that require model inheritance or field additions. It integrates via middleware and a single INSTALLED_APPS entry, then runs migrations to set up its tables. Configuration is optional but extensive—you can exclude specific models or URLs, customize which event types to log, plug in alternative logging backends, and control admin visibility. The fact sheet shows it supports Django 4.2 through 6.0 and Python 3.9–3.14, with no known security vulnerabilities.

Use it for:

• Compliance and regulatory auditing: track all data modifications to meet audit trail requirements in regulated industries.
• User accountability: log who created, modified, or deleted records and when, without adding audit fields to every model.
• Debugging and incident response: query historical changes to understand what happened during a production issue.
• Admin interface monitoring: review authentication attempts and failed logins to detect suspicious activity.
• Data governance: exclude sensitive models or URLs from logging via configuration without code changes.
• Custom audit backends: route audit events to external systems via pluggable backend interface.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Logs every CRUD operation, authentication event, and HTTP request in a Django project automatically via signals, storing them in queryable database models without requiring code changes to your existing models.

Yes, with conditions. Install if you need automatic audit logging in a Django project and can accept GPLv3 copyleft licensing. The low install friction, active maintenance, and zero known vulnerabilities make it a solid choice for compliance and accountability use cases. Do not install if your project is proprietary and cannot comply with copyleft obligations.

Install

django-easy-audit on PyPI

pip install django-easy-audit

uv add django-easy-audit

poetry add django-easy-audit

Installing django-easy-audit

Before you install

Low friction: pure Python wheel with only django as a runtime dependency. Actively maintained with a recent release (45 days ago) and 844 repository stars. Supports current Python versions (3.9–3.14) and modern Django versions (4.2–6.0).

License in practice

Licensed under GPLv3 (copyleft). Any derivative work or distribution must be released under the same license; proprietary projects cannot use this package without complying with copyleft obligations or obtaining an alternative license.

Quickstart

pip install django-easy-audit

# In settings.py, add to INSTALLED_APPS:
INSTALLED_APPS = [..., 'easyaudit']

# Add to MIDDLEWARE:
MIDDLEWARE = (..., 'easyaudit.middleware.easyaudit.EasyAuditMiddleware')

# Run migrations:
python manage.py migrate easyaudit

Requires django to be installed and configured; migrations must be run before audit logging begins.

Verify before relying

• Performance impact on high-volume CRUD operations or large-scale deployments is not quantified.
• Storage requirements and retention policies for long-term audit logs are not specified.
• Compatibility with custom user models or multi-database setups beyond the documented DJANGO_EASY_AUDIT_DATABASE_ALIAS setting.
• Whether DJANGO_EASY_AUDIT_USER_DB_CONSTRAINT setting is functional or still reserved for future use.

Package facts

Evidence: django_easy_audit-1.3.9-py3-none-any.whl

Tags

More Python Modules packages