Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install blueberrypy

How to install blueberrypy

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install blueberrypy
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
0.5.4Never BuiltWhy not?
0.5.1 Available View build log
Windows (64-bit)
0.5.4Never BuiltWhy not?
0.5.1 Available View build log
Mac OS X (10.5+)
0.5.4Never BuiltWhy not?
0.5.1 Available View build log
Linux (32-bit)
0.5.4Never BuiltWhy not?
0.5.3 Available View build log
0.5.1 Available View build log
Linux (64-bit)
0.5.4 Available View build log
0.5.3 Available View build log
0.5.1 Available View build log
Lastest release
version 0.5.4 on Jan 9th, 2014

Same as CherryPy, just with a different filling.

What is it?

BlueberryPy is a CherryPy project skeleton generator and a collection of tools, plugins and utilities for CherryPy - the minimalist Python web framework.

What does it offer?

BlueberryPy is offered as a set of CherryPy tools, WSPB plugins and extra utility modules. All the components are optional and completely pluggable without any intermodule dependencies, so you can safely pick and choose just the components you want.

  • SQLAlchemy ORM plugin with two-phase commit support
  • Per-request SQLAlchemy ORM session tool
  • Redis session storage
  • Jinja2 template engine
  • Webassets asset pipeline integrated with Jinja2
  • Application specific logging
  • CherryPy project skeleton generator
  • Preconfigured console for experimenting inside a generated project
  • YAML configuration for CherryPy, Python's logging module and Webassets
  • Convenient Email module for sending text and HTML emails
  • JSON tools to convert to and from SQLAlchemy models
  • CSRF token


Stable version:

$ pip install blueberrypy

Development version:

$ pip install https://bitbucket.org/wyuenho/blueberrypy

Note: You should probably install it inside a virtualenv.


Once BlueberryPy is installed, a script called blueberrypy should be available on your PATH.

usage: blueberrypy [-h] [-v] [-C CONFIG_DIR] [command]

BlueberryPy lightweight pluggable Web application framework command line interface.

   Type 'blueberrypy -h' or 'blueberrypy --help' for general help.
   Type 'blueberrypy help <command>' for help on that specific command.


   help                print this help or a command's if an argument is given
   create              create a project skeleton
   console             BlueberryPy REPL for experimentations
   bundle              bundles up web assets (type 'blueberrypy help bundle' for details)
   serve               spawn a new CherryPy server process

positional arguments:
   command               the action to perform

optional arguments:
   -h, --help            show this help message and exit
   -v, --version         print version information and exit.
   -C CONFIG_DIR, --config_dir CONFIG_DIR
                         path to the config directory

To create a project skeleton:

$ blueberrypy create

After you've answered a couple of questions, you should see something similar to this:

Your project skeleton has been created under /path/to/your/project .

Subsystems chosen
Routes (RESTful controllers): True
Jinja2: True
webassets: True
redis: False
SQLAlchemy: True

If you install a development version of your package now, the dependencies will be automatically installed for you as well:

$ pip install -e .

You can install the optional speedup packages too:

$ pip install blueberrypy[speedups]

Finally, you need to install a database driver such as psycopg2:

$ pip install psycopg2

Now your package is ready to be served:

$ blueberrypy serve

Type http://localhost:8080 into your browser's location bar and voila!

Happy coding!


  1. write sphinx doc
  2. minimalist, conditional validators for json utils and form inputs
  3. babel integration
  4. request handler cache decorator
  5. search engine integration
  6. alembic or sqlalchemy-migrate integration
  7. modularize skeleton generation and commands
  8. better test coverage

Subscribe to package updates

Last updated Jan 9th, 2014

Download Stats

Last month:2

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.