[![Build Status](https://travis-ci.org/vmware/pyvmomi.svg?branch=master)](https://travis-ci.org/vmware/pyvmomi) 
[![Downloads](https://pypip.in/download/pyvmomi/badge.png)](https://pypi.python.org/pypi/pyvmomi/)

pyVmomi is the Python SDK for the VMware vSphere API that allows you to manipulate ESX, ESXi, and vCenter.

To get started, check out the samples project at http://vmware.github.io/pyvmomi-community-samples/

* community discussion on IRC freenode.net channels [#pyvmomi and #pyvmomi-dev](http://webchat.freenode.net/?channels=#pyvmomi,#pyvmomi-dev)

You can install this as a package. The official release is availabe using pip, just run `pip install pyvmomi`. To install the version listed here use `python setup.py develop` for development install or `python setup.py install`. The master is code that is in development, official releases are tagged and posted to [pypi](https://pypi.python.org/pypi/pyvmomi/).

There are other bindings of this API in other languages. See:

* **vijava** (Java): http://vijava.sourceforge.net/
* **rbvmomi** (Ruby): https://github.com/vmware/rbvmomi
* **vSphere SDK for Perl** (non-free): https://my.vmware.com/group/vmware/details?downloadGroup=VSP510-SDKPERL-510&productId=285

For general language neutral documentation of vSphere Management API see:
http://pubs.vmware.com/vsphere-55/index.jsp#com.vmware.wssdk.apiref.doc/right-pane.html

Python Support
==============
pyVmomi currently supports Python 2.6 and 2.7; support for Python 3.x is currently in progress.

Releases
========
* [5.1.0](https://github.com/vmware/pyvmomi/tree/v5.1.0)
* [5.5.0](https://github.com/vmware/pyvmomi/tree/v5.5.0)
* Next release in progress [5.5.0_2014.1](https://github.com/vmware/pyvmomi/issues?milestone=1&state=open)

Related Projects
================
* Feature Incubator: [pyvmomi-tools](https://github.com/vmware/pyvmomi-tools)
* Samples Project: [pyvmomi-community-samples](https://github.com/vmware/pyvmomi-community-samples)

Have fun!