---
id: django-imagekit
version: "6.1.0"
license: BSD
license_treatment: permissive
maintenance: active
---

# django-imagekit — Automated image processing for Django models.

License: permissive · Maintenance: active · Downloads: 521.4K/mo

## What it is and what it does

django-imagekit is a Django app that automates image processing by letting you define image transformations declaratively on your models. Instead of manually resizing, cropping, or converting images in views or signals, you specify what you want—a thumbnail, a black-and-white version, a resized copy—using image specs, and ImageKit generates and serves them on demand. It works by attaching ImageSpecField or ProcessedImageField to your Django models, each backed by a set of processors (resize, crop, format conversion, etc.) that transform a source image into a derived one.

The package comes with built-in processors for common tasks like resizing and cropping, and you can write custom processors for specialized transformations. Image specs can be defined on models for automatic generation, used directly in views for programmatic control, or registered and invoked from templates. The generated images are typically cached so repeated requests don't re-process the source. It depends on pilkit for the actual image manipulation and django-appconf for Django settings integration.

Use it for:

- Generate and serve user avatar thumbnails automatically when a profile image is uploaded.
- Create multiple derived image sizes (mobile, tablet, desktop) from a single source upload.
- Convert uploaded images to a standard format or quality level without storing the original.
- Build image galleries that display resized previews without manual pre-processing.
- Apply consistent image transformations (crop, rotate, filter) across a Django app from template tags.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Automated image processing for Django models—generates thumbnails, resized versions, and transformed images from uploaded files using declarative specs.

Yes. django-imagekit is a mature, actively maintained package (production-stable, recent commits, 2349 GitHub stars) with low install friction and no known vulnerabilities. It solves a common Django problem—automated image processing—cleanly and declaratively. The BSD license is permissive. Install it if you need to generate derived images from user uploads or other sources in a Django project.

## Install

pip install django-imagekit
uv add django-imagekit
poetry add django-imagekit

## Installing django-imagekit

Before you install: Low install friction with only two runtime dependencies (django-appconf and pilkit). Active maintenance with recent commits and a stable production status.

License in practice: BSD license permits commercial and private use with minimal restrictions—no copyleft obligations or patent clauses to navigate.

Quickstart:

pip install django-imagekit

from django.db import models
from imagekit.models import ImageSpecField
from imagekit.processors import ResizeToFill

class Profile(models.Model):
    avatar = models.ImageField(upload_to='avatars')
    avatar_thumbnail = ImageSpecField(
        source='avatar',
        processors=[ResizeToFill(100, 50)],
        format='JPEG',
        options={'quality': 60}
    )

profile = Profile.objects.first()
print(profile.avatar_thumbnail.url)

Requires Pillow to be installed separately for image processing; Django and a configured image storage backend are prerequisites.

Verify before relying:

- Whether generated images are cached or regenerated on each access
- Storage backend options beyond the default file system
- Performance characteristics with large image volumes or concurrent processing

## Package facts

- License: BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 521.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django image processing, thumbnail generation, image resizing django, automated image transformation, django imagekit specs, image field processing, django image caching, django-integration, image-processing

[View on SkillFed](https://skillfed.io/packages/django-imagekit) · [View on PyPI](https://pypi.org/project/django-imagekit/)