All you need is a working version of Python-2.3 or later on your computer. If you are running Max OS X or some Linux distribution (e.g. Ubuntu, Debian, Fedora) you most likely already have python on you system, for a detailed instruction on how to install python follow the instruction on the python wiki.
Download Stable Versions
Using pip or easy_install
$ pip install CherryPy
or with easy_install:
$ easy_install CherryPy
It is recommended to use pip instead of easy_install. If you want to download and install CherryPy for yourself proceed to the next instructions depending on your platform.
You may download the most current version from PyPI
For other releases, browse our download index.
- Unzip/untar the files
- Enter the directory created by the file extraction.
- Type "python setup.py install" to install the CherryPy module
- To run your first sample website, go to cherrypy/tutorial/ and type "python tut01_helloworld.py", and you'll have a running website on port 8080.
- Open your favorite browser and point it to http://localhost:8080 to see your first CherryPy-served page :-)
Now, you should try running some of the other tutorials found in the tutorial directory and look at their source code to understand how to develop a website with CherryPy.
CherryPy's source code is managed using Mercurial, a source code control system written in python.
You can access our Mercurial repository using your favorite Mercurial client at bitbucket.
For Windows users, we recommend the wonderful Mercurial client TortoiseHg. Users of other operating systems are advised to use multi-platform command line tools provided by the core Mercurial distribution.
- To submit a patch fork the repository and submit your pull request. For further information please contact us via email or IRC (see getting involved).
Standalone WSGI server
The WSGI server that comes bundled with CherryPy is available as a standalone module. Feel free to use it for all of your WSGI serving needs.