Personal tools
You are here: Home Project Grok Releases 1.0a1


A feature release and a first step on the way to Grok 1.0!

The Grok team is happy to announce the release of Grok 1.0a1. This is the first step on the way to the release of Grok 1.0! With Grok 1.0 we will deliver a stable, powerful, featureful framework for Python-based web development. Grok 1.0a1 is a preview of the 1.0 release and a continuation of the developments in Grok 0.14.


Grok 1.0a1 has the following changes compared to Grok 0.14:

  • Grok now uses WSGI and paster out of the box. To create a project that uses paster, update grokproject (easy_install -U prokproject) first.
  • Grok's REST support now works like layers have been for a while, using a grok.restskin directive on an interface.
  • A new grok.DirectoryResource component is available that can be used to expose resources (CSS, Javascript, images) to the web the Grok way, similar to the way the ZCML resourceDirectory directive can be used.
  • We have split off a new package that Grok now depends on which contains the viewlet support (grokcore.viewlet). The use of viewlets with Grok remains unchanged, but this package can also be used independently.
  • Besides our existing documentation we have started to add docstrings to the Grok source code to make it easier to understand.

This release also contains a number of bugfixes. We are continuing to fix bugs on the way to Grok 1.0.

For installation instructions and much more on how to use Grok, see the Grok tutorial:


It should not be needed to change your code to upgrade an existing project from 0.14 to 1.0a1, unless you use Grok's REST support.

For detailed upgrade notes on this, see

If you want to use the paster support, please examine a project generated with the newest version of grokproject and update your project's buildout.cfg accordingly (and help us write better instructions!).

We hope to hear from you!

If you enjoy Grok, please subscribe to the grok-dev mailing list and join us in the #grok channel on