Getting started

  • Install birdy with pip install birdhouse-birdy

  • Connect to a Raven WPS server. You may deploy your own version or use the server hosted at Ouranos.

from birdy import WPSClient
url = ""
wps = WPSClient(url)

The wps object behaves as a module, holding functions that, instead of being executed on your machine, call a remote process on the server. See the notebook tutorials for examples.

If you don’t want to install anything and just try it, go to and login with the public account and the public password. Note that your notebooks will be publicly visible and modifiable, so don’t leave anything valuable there. Also, from time to time we’ll reset the public folders, so make sure you keep a local copy of your work.