django-cleanup
Deletes old files.
Decision gist · record as of 2026-08-14
Yes. django-cleanup solves a common Django problem (orphaned files) with zero configuration beyond adding it to INSTALLED_APPS. No runtime dependencies, permissive license, and a stable codebase with 1213 GitHub stars make it a low-risk addition. The aging maintenance status is not a concern given the package's narrow, well-defined scope and recent commit activity. Install it unless your project uses a non-transactional database or shares files across multiple model instances (both documented limitations).AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Must be placed at the bottom of INSTALLED_APPS to ensure signal handler integrity; models must be properly loaded in models.py or models/__init__.py for discovery to work.
- Low friction install with no runtime dependencies.
- Maintenance status is aging—last release was 695 days ago—but the repository remains active with recent commits and no archived status, suggesting the package is stable rather than abandoned.
License · maintenance · safety
permissive license (permissive) — MIT license (permissive) allows free use, modification, and distribution with minimal restrictions, making it safe to integrate into most projects without legal concern.
last release 2024-09-18 (695 days) · last repo commit 2025-06-05 · 1,213 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 702,420 downloads/mo, #5,284 on PyPI
Alternatives
Verify before relying
pip install django-cleanup
Add to settings.py INSTALLED_APPS:
INSTALLED_APPS = (
...,
'django_cleanup.apps.CleanupConfig',
)- Whether the package handles all file storage backends (S3, Azure, etc.) or only local filesystem storage.
- Performance impact when models have many FileField instances or bulk delete operations occur.
- Behavior with soft-delete patterns or custom deletion logic in model managers.
What it is and what it does
django-cleanup is a Django app that automatically manages file cleanup for FileField and ImageField instances. It hooks into Django's model signals (post_init, pre_save, post_save, post_delete) to track when files are replaced or models are deleted, then schedules file deletion within the current transaction. This prevents orphaned files from accumulating on disk when you update or remove model instances.
The package works transparently once installed—you add it to INSTALLED_APPS (at the bottom to avoid signal handler conflicts) and it discovers all FileField instances in your models. It maintains a local cache of original field values to detect changes, and integrates with Django's transaction system to ensure deletions happen safely. It includes advanced features like pre/post-delete signals for integrating with thumbnail libraries, a refresh method for cache management, and decorators to selectively ignore or include specific models.
Use it for
- Remove old product images when updating an e-commerce catalog without leaving orphaned files on disk.
- Clean up user profile pictures when accounts are deleted or users upload new avatars.
- Prevent storage bloat in document management systems when old versions are replaced.
- Integrate with thumbnail libraries to delete generated thumbnails alongside original images.
- Ensure file consistency in multi-tenant applications where model deletions must not leave dangling file references.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
django-cleanup solves a common Django problem (orphaned files) with zero configuration beyond adding it to INSTALLED_APPS. No runtime dependencies, permissive license, and a stable codebase with 1213 GitHub stars make it a low-risk addition. The aging maintenance status is not a concern given the package's narrow, well-defined scope and recent commit activity. Install it unless your project uses a non-transactional database or shares files across multiple model instances (both documented limitations).
Install
django-cleanup on PyPI
Before you install
Low friction install with no runtime dependencies. Maintenance status is aging—last release was 695 days ago—but the repository remains active with recent commits and no archived status, suggesting the package is stable rather than abandoned.
Must be placed at the bottom of INSTALLED_APPS to ensure signal handler integrity; models must be properly loaded in models.py or models/__init__.py for discovery to work.
License in practice
MIT license (permissive) allows free use, modification, and distribution with minimal restrictions, making it safe to integrate into most projects without legal concern.
Quickstart
pip install django-cleanup
Add to settings.py INSTALLED_APPS:
INSTALLED_APPS = (
...,
'django_cleanup.apps.CleanupConfig',
)Verify before relying
- Whether the package handles all file storage backends (S3, Azure, etc.) or only local filesystem storage.
- Performance impact when models have many FileField instances or bulk delete operations occur.
- Behavior with soft-delete patterns or custom deletion logic in model managers.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 695 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 702,420 / month, #5,284 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: Web EnvironmentFramework :: DjangoIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Utilities |
Evidence: django_cleanup-9.0.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “django file cleanup”
- django-cleanupAutomatically deletes old files when Django FileField and ImageField…
- django-dramatiqIntegrates Dramatiq, a distributed task queue, into Django…
- easy-thumbnailsGenerates and manages thumbnail images for Django applications,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also drf-extra-fields · django-deprecate-fields · pyclean · django-clone · sorl-thumbnail · django-soft-delete · django-browser-reload · django-test-migrations · django-lifecycle · django-safedelete