Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Enterprise-grade runtime supervisor
Failed to load latest commit information.
docs Documenting unsetting env variable
ramona Removing TODO and providing in-source explanation.
.gitignore Adding Idea IDE configuration files to ignore
AUTHORS Tuning project credits (preparation for first beta release).
LICENSE.txt Synchronizing with Python distutil standards. Adding new .tmpl.html files.
README Adding link to mailing list. Adding link to mailing list.
demo.conf Removing obsolete configuration options. Specifying python version.
gource.config add docstrings for help output
ramona.conf Cherry-picking from d3cf598 / Switch from URI params to URI query string Updating version info after release.
test.conf Adding autorestart to test configuration. Specifying python version.


Your next favorite supervisor component.

Ramona is an enterprise-grade runtime supervisor that allows controlling and monitoring software programs during their execution life cycle.

It provides supervisor/console functionality of init.d-like start/stop control, continuous integration (e.g. unit/functional/performance test launcher), deployment automation and other command-line oriented features. It is design the way that you should be able to extend that easily if needed (e.g. to include your own commands or tasks).

It is implemented in Python but it is not limited to be used only in Python projects.

Target platforms are all modern UNIXes, BSD derivates and Windows.

Quick introduction

Let's assume your project (named foo) directory looks as follow:

    docs/ <--- this is Ramona

Ramona system will the provide you with following command-line API:

$ ./ --help
usage: [-h] [-c CONFIGFILE] [-d] [-s]

optional arguments:
  -h, --help            show this help message and exit
                        Specify configuration file(s) to read (this option can
                        be given more times). This will override build-in
                        application level configuration.
  -d, --debug           Enable debug (verbose) output.
  -s, --silent          Enable silent mode of operation (only errors are

    start               Launch subprocess(es)
    stop                Terminate subprocess(es)
    restart             Restart subprocess(es)
    status              Show status of subprocess(es)
    help                Display help
    console             Enter interactive console mode
    server              Launch server in the foreground


Something went wrong with that request. Please try again.