Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Add kittens and kitten voting to your django project!

Project Description

Add kittens to your django project! This app collects kittens from the /r/aww/ subreddit and displays them to users, who can then upvote or downvote them. It also provides a “top kittens page”

This project was created to demonstrate how to package a django app for distribution. It accompanies the presentation given at this Code & Supply: Django PGH Meetup.

Installation and Configuration

Installing django-kittens is as simple as:

pip install django-kittens

It can be included in any Django app by adding 'django-kittens' to you INSTALLED_APPS setting.

This application can be further configured by adding some entries into your django settings module.

REDDIT_USER_AGENT = 'packaging-kittens'

The config item REDDIT_USER_AGENT tells the reddit-api who is making requests. Set this to something unique for your app. If left at the default setting, your rate limit will be shared with any other project that includes this app with the default setting.

The KITTEN_FRESHNESS setting controls what proportion of kittens will be new, and can be set to any positive integer. A low freshness level will tend to show the same collection of kittens over time, while a high freshness level will constantly show new kittens.

The setting KITTEN_HOMEPAGE is the url that the “home” link on the kittens pages will link to.


This project is not being actively developed. But, I’m happy to look at pull requests.


All code is licensed under the MIT license. See attached LICENSE.txt.

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(6.1 kB) Copy SHA256 Hash SHA256
Source Jul 8, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting