skip to navigation
skip to content

ratchet-agent 0.1.11 server-side agent

Latest Version: 0.2.4

A daemon to monitor log files and push messages to


ratchet-agent requires:

  • A unix-like system (tested on Fedora Linux and Mac OS X)
  • Python 2.6+
  • requests 0.13.1+
  • a account


Install with pip:

pip install ratchet-agent

See Configuration for configuration options to make it actually useful.

Ratchetd comes with an example init.d script, chkconfig compatible and tested on Fedora Linux. To install it, symlink to /etc/init.d/ratchet-agent and add to chkconfig:

ln -s /path/to/ratchet-agent/ /etc/init.d/ratchet-agent
chkconfig --add ratchet-agent
chkconfig on ratchet-agent
service ratchet-agent start


Configuration options for ratchet-agent itself are in ratchet-agent.conf. If you’re using the init script, it has a few of its own configuration variables inside which control how it runs.

“ratchet-agent.conf“ At the bare minimum, you will want to change the following variables:

  • params.access_token – your access token
  • targets – white-space-separated list of files or directories (non-recursive) to process.

Setting the following variables will enable github integration:

  • params.root – path to your code root
  • params.branch – the current branch
  • params.github.account – your github account name
  • params.github.repo – your github repo name

Other options are documented in the sample config file.

““ Configuration variables should be self-explanatory. If you’re not using a virtualenv, set VIRTUALENV="".


Contributions are welcome. The project is hosted on github at

Additional Help

If you have any questions, feedback, etc., drop me a line at

File Type Py Version Uploaded on Size
ratchet-agent-0.1.11.tar.gz (md5) Source 2012-07-24 8KB