---
id: pyone
version: "7.3.80"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pyone — Python Bindings for OpenNebula XML-RPC API

License: permissive · Maintenance: active · Downloads: 95.2K/mo

## What it is and what it does

PyOne is a Python client library that wraps the OpenNebula cloud management platform's XML-RPC API. It translates OpenNebula's remote procedure calls into Python objects and methods, so you can manage virtual machines, hosts, networks, and storage pools from Python scripts or applications instead of using the command-line tools or web interface.

The package handles XML serialization and deserialization internally, working with lxml and xmltodict to convert between Python data structures and the XML format OpenNebula expects. It depends on requests for HTTP communication and grpcio as a runtime dependency. It's designed for developers building automation, monitoring, or orchestration tools around OpenNebula infrastructure, and requires a running OpenNebula server and valid API credentials to function.

Use it for:

- Automate VM provisioning and lifecycle management (create, start, stop, delete) in OpenNebula clusters.
- Build custom monitoring or reporting dashboards that query OpenNebula resource state via Python.
- Integrate OpenNebula with external orchestration or CI/CD systems through Python scripts.
- Manage network and storage resources programmatically without manual web console interaction.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to the OpenNebula XML-RPC API, enabling programmatic control of OpenNebula cloud infrastructure through Python code.

Yes, if you are building tools or automation around an OpenNebula deployment. The package is actively maintained, has low install friction, carries a permissive license, and has no known vulnerabilities. Install only if you have an OpenNebula server to connect to; it is not useful as a standalone library.

## Install

pip install pyone
uv add pyone
poetry add pyone

## Installing pyone

Before you install: Low install friction with a pure-wheel distribution. Actively maintained with a release 32 days ago. Depends on 7 runtime packages including lxml, requests, and grpcio—all established libraries with stable ecosystems.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and derivative use with attribution and patent protection. No restrictions on bundling or modification.

Quickstart:

pip install pyone

import pyone

one = pyone.OneServer('http://localhost/RPC2', session='user:password')
vms = one.vmpool.info()

Requires OpenNebula server running and accessible at the configured XML-RPC endpoint; authentication credentials must be valid.

Verify before relying:

- Whether grpcio is actually used at runtime or is an unused transitive dependency.
- Current state of OpenNebula server compatibility (versions supported by 7.3.80).
- Whether the package supports async/await patterns or is synchronous-only.
- Specific port and endpoint configuration for connecting to OpenNebula servers.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 95.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

opennebula python api, cloud infrastructure automation, xml-rpc bindings, opennebula management, infrastructure as code python, cloud-infrastructure, api-client, orchestration

[View on SkillFed](https://skillfed.io/packages/pyone) · [View on PyPI](https://pypi.org/project/pyone/)