skillfed

cloudinary

Python and Django SDK for Cloudinary

cloudinary v1.45.0 2.3M downloads/30d#3,180 on PyPI263
Permissive license Released under the MIT license. Contains MIT licensed code from https://bitbucket.org/chrisatlee/poster Active released

What it is and what it does

Cloudinary is a Python SDK that connects your application to Cloudinary's media management platform, handling image and video uploads, transformations, optimization, and delivery. It abstracts the complexity of working with media assets by providing high-level functions for common tasks like resizing, cropping, filtering, and generating secure delivery URLs. The package includes first-class Django integration through form and model helpers, making it straightforward to add media management to Django applications.

The SDK sits between your application and Cloudinary's cloud infrastructure, managing authentication, request formatting, and response parsing. It supports a wide range of transformation parameters and can generate optimized tags for embedding images and videos in web pages. With low install friction and active maintenance, it's designed for developers who want to offload media handling to a specialized service rather than managing assets locally.

Use it for:

  • Upload user-generated images and videos to Cloudinary while handling validation and storage in a Django web application.
  • Transform images on-the-fly (resize, crop, apply filters) and generate optimized URLs for responsive web delivery.
  • Generate secure, signed URLs for media assets to control access and prevent unauthorized distribution.
  • Integrate media upload forms into Django models and admin interfaces using the SDK's Django helpers.
  • Optimize and convert video formats for multi-device playback across web and mobile platforms.

Worth the install?

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

Cloudinary Python SDK provides image and video upload, transformation, optimization, and delivery through Cloudinary's cloud platform, with built-in Django integration and secure URL generation.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and offers low install friction. It's well-suited for applications that need reliable media management and transformation without building that infrastructure in-house. Django projects in particular benefit from its native integration. Install it if you're using Cloudinary or considering a managed media platform.

Install

cloudinary on PyPI

pip

pip install cloudinary

uv

uv add cloudinary

poetry

poetry add cloudinary

Installing cloudinary

Before you install

Low install friction with only three lightweight runtime dependencies (six, urllib3, certifi). Active maintenance with a recent release 44 days ago and ongoing repository activity.

License in practice

MIT license (permissive) allows commercial and private use with minimal restrictions; includes MIT-licensed code from an external source.

Quickstart

pip install cloudinary

import cloudinary
cloudinary.utils.cloudinary_url("sample.jpg", width=100, height=150, crop="fill")
cloudinary.uploader.upload("my_picture.jpg")

Requires a Cloudinary account and API credentials configured in your environment to authenticate uploads and transformations.

Verify before relying

  • Whether the package supports Python 2.7 as indicated in the version support table, given that Python 2.7 reached end-of-life in 2020.
  • Current state of Django 1.11 and 2.x support claims, as these Django versions are no longer actively maintained.

Package facts

License Released under the MIT license. Contains MIT licensed code from https://bitbucket.org/chrisatlee/poster (permissive)
Python support not specified
Install friction low — pure-Python wheel
Runtime dependencies 3 — six, urllib3, certifi
Maintenance actively maintained — 44 days since the last release
Last repo commit
First released
Downloads 2,266,216/month — #3,180 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: cloudinary-1.45.0-py3-none-any.whl

Keywords: cloudinary, image, video, upload, crop, resize, filter, transformation, manipulation, cdn

Development Status :: 5 - Production/StableEnvironment :: Web EnvironmentFramework :: DjangoFramework :: Django :: 1.11Framework :: Django :: 2.2Framework :: Django :: 4.2Framework :: Django :: 5.0Framework :: Django :: 5.1Framework :: Django :: 5.2Framework :: Django :: 6.0Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: PythonProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Internet :: WWW/HTTPTopic :: Internet :: WWW/HTTP :: Dynamic ContentTopic :: Multimedia :: GraphicsTopic :: Multimedia :: Graphics :: Graphics ConversionTopic :: Multimedia :: Sound/AudioTopic :: Multimedia :: Sound/Audio :: ConversionTopic :: Multimedia :: VideoTopic :: Multimedia :: Video :: ConversionTopic :: Software Development :: Libraries :: Python Modules

Tags

image upload and transformationvideo management sdkcloudinary python integrationimage optimization and deliverydjango media managementcdn asset managementimage crop resize filter
media-managementdjango-integrationcdn-delivery

More Python Modules packages