A simple web application that allows you to uploads photos, maintain a database with references to them, list them with their metadata, and display them using various cloud-based transformations.

This sample project depends on Cloudinary's Python library.

Run the following commands from your shell.

Project cloning and dependent package installation:

git clone git://github.com/cloudinary/cloudinary-django-sample.git    
cd cloudinary-django-sample
pip install -r requirements.txt

Defining Cloudinary's credentials. The CLOUDINARY_URL value is available in the dashboard of your Cloudinary account. If you don't have a Cloudinary account yet, click here to create your free account.

export CLOUDINARY_URL=cloudinary://<API-KEY>:<API-SECRET>@<CLOUD-NAME>

Creating a local database and running a web server:

python ./manage.py migrate --run-syncdb
python ./manage.py runserver

You can now browse to the following link to start exploring the sample.

http://localhost:8000/

The sample app also supports the Django admin which is available here:

http://localhost:8000/admin

We recommend and support the usage of virtualenv. All you need to do is create a new virtualenv (if necessary):

virtualenv venv

And then just activate it:

source venv/bin/activate

Now you can go ahead with the instructions above.