Using PIP

The latest stable-ish build:

pip install django-flickr

Development version:

pip install hg+

From source

hg clone
cd django-flickr
./ install


  • Django 1.4
  • Bunch - to ease up managing json data
  • Taggit - for handling tags
  • Taggit-templatetags - not obligatory really, but it’s an awesome addition to taggit and the example view uses it
  • Oauth2 - for auth


Add ‘flickr’ to your INSTALLED_APPS and syncdb

Go to ‘Your apps’ on Flickr and generate an API key for your app. Put those data in your

FLICKR_KEY = 'xxxxxxxxxxxx'
FLICKR_SECRET = 'xxxxxxx'

and add flickr.urls to your

Authenticate your Flickr account

Run your django app, sign in. Go to /flickr/auth/ and click on the link. Authorize your app on flickr. If your app is public, you’ll be redirected to complete the auth process, if not (f.ex. you set up some bogus link), just copy the GET frob variables to your /flickr/auth url. Currently it uses FlickrAuth (set to be deprecated some day probably), not Oauth. (Oauth support is implemented, but untested well. You can try it.)

The Flickr API fully supports oAuth, which is already used by hundreds of Flickr apps, but there are still some apps that use the old authentication system, called FlickrAuth. We are asking all developers to move over to the new standard bu July 31. There is a related blog post on this topic on our engineering blog


South is used for migrations. Project is in early stages so expect them.