cherrypy Getting started with cherrypy Installation instructions



  • These instructions suppose you have any type of Linux, Unix, Mac with bash or Git-bash Windows.
  • Windows: Download and install Git-bash for Windows, then execute 'bash' from command line.
  • Other shells than bash are fine too, just replace the activate command below with activate.csh or Google: "virtualenv activate your-shell-name".

Before you start, check that Python, virtualenv and pip are installed:

  • $ python --version
  • $ virtualenv --version
  • $ pip --version


Create a directory with your web/app, create environment and install CherryPy package.

  • $ mkdir /develop/myapp/
  • $ cd /develop/myapp/
  • $ virtualenv venv
  • $ source venv/bin/activate
    • On Windows in Git-bash: $ source venv/Scripts/activate
  • (venv) $ pip install cherrypy
  • (venv) $ python
Python 3.5.2 ...
>>> import cherrypy
>>> cherrypy
<module 'cherrypy' from '... venv/site-packages/cherrypy/'>

Congratulations! Now you are ready for your first CherryPy application.