Skip to main content

Lightweight gevent program runner

Project description


GRunner ‘Gevent Runner’ is a Python Gevent Server for UNIX. It’s a pre-fork worker model inspired by Gunicorn project. The GRunner server is simply implemented, light on server resource usage, and fairly speedy.


GRunner requires Python 2.x >= 2.6.

Install from sources:

$ python install

Or from Pypi:

$ easy_install -U grunner

Basic Usage

After installing GRunner you will have access to three command line scripts grunner.

Commonly Used Arguments

  • -b BIND, --bind=BIND - Specify a server socket to bind. Server sockets can be any of $(HOST), $(HOST):$(PORT). An IP is a valid $(HOST).
  • -w WORKERS, --workers=WORKERS - The number of worker processes. This number should generally be 2 workers per core in the server.

There are various other parameters that pidfile, pythonpath, logging, etc. You can see the complete list with the expected:

$ grunner -h


The first and most basic script is used to server ‘bare’ WSGI applications that don’t require a translation layer. Basic usage:


Where APP_MODULE is of the pattern $(MODULE_NAME):$(VARIABLE_NAME). The module name can be a full dotted path. The variable name refers to a WSGI callable that should be found in the specified module.

Example with test app:

$ cd examples
$ grunner --workers=2 --bind  -d  -log=/log/file/path --pythonpath=/project/dir/ test:app


GRunner is released under the MIT License. See the LICENSE file for more details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
GRunner-0.3.4.tar.gz (10.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page