Skip to main content

Open Cloud Computing Interface Client/Server Library

Project description



occy-py is a generic library implementation of the Open Cloud Computing Interface.

The Open Cloud Computing Interface (OCCI) comprises a set of open community-lead specifications delivered through the Open Grid Forum. OCCI is a Protocol and API for all kinds of Management tasks. See

The occi-py library is a complete implementation of the OCCI specification and supports version 1.1 of the OCCI RESTful Protocol.

The aim of occi-py is to provide a high-level interface for easy integration of the OCCI Standard Protocol into both new and existing applications.


  • Easy to use. Implement the 5 required ServerBackend methods and you are ready to go.

  • Pluggable HTTP server front-end. A Tornado front-end is included.

  • Focused on robustness and standard compliance.

  • Supports all Content Types defined by the OCCI HTTP Rendering specification and all of the OCCI Infrastructure Kind/Mixin definitions.

  • Easy to extend with custom Entity types as outlined in the OCCI Core specification.


You can install occi-py either via the Python Package Index (PyPI) or from source.

To install using pip:

$ pip install occi

To install using easy_install:

$ easy_install occi

If you have downloaded a source tarball you can install it by doing the following,:

$ python build
# python install # as root

OCCI Server

To enable OCCI server support in your application you must implement the occi.server.ServerBackend class. See the stub method documentation for further information.

IaaS Demo

A demo implementation of the OCCI Infrastructure specification is provided by script. The demo uses the Tornado front-end and thus requires the Tornado framework to be installed.

To start the demo install occi-py and run:


You will then have an OCCI server listening to port 8000 on localhost. To use a different base URL specify the –base_url option, e.g.:

$ --base_url

OCCI Client



The occi-py library is fairly stable but it is still under development and subject to internal API changes.

A Redis backend is in the works and will provide a better example on how to use the library in real applications.

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to our issue tracker at


Development of occi-py happens at Github:

You are highly encouraged to participate in the development. If you don’t like Github (for some reason) you’re welcome to send regular patches.


This software is licensed under the GNU Lesser General Public License (LGPL) version 3. See the LICENSE file in the top distribution directory for the full license text.

Project details

Download files

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

Source Distribution

occi-0.6.tar.gz (38.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page