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.


soil is unavailable in PyPM, because there aren't any builds for it in the package repositories. Click the linked icons to find out why.

 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
Linux (64-bit)

Better prototyping with Jinja2 and a shameless ripoff of lucuma/Clay.


$ pip install soil

Or, if you really wanted to:

$ git clone git://github.com/kuyan/soil.git
$ cd soil && python setup.py install

Or, if you really, really wanted to:

$ easy_install soil

But, to quote Kenneth Reitz:

... you really shouldn't do that.

Quick Start

First, create a new project and start editing:

$ shovel new new_project/
$ cd new_project/

Edit templates (see: Jinja2):

$ vim templates/index.html

Check out your project in your browser:

$ shovel run

You'll be able to see your site at

Turn the templates into static HTML:

$ shovel build

The output will be stored in the build/ directory.

Want to know more? Check out the documentation.


  • Extensions!
  • Uses Jinja2 for templating.
  • And that’s pretty much everything notable. soil is pretty simple.



Soil uses pytest. To run the tests:

pip install pytest
git clone git://github.com/kuyan/soil.git
py.test soil/soil/test/

MIT licensed Copyright (C) 2012 Natan L

Subscribe to package updates

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.