---
id: vers-sdk
version: "1.20.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# vers-sdk — SDK for Orchestrator Control Plane API

License: permissive · Maintenance: active · Downloads: 2.2M/mo

## What it is and what it does

Vers-sdk is a generated Python client library for the Vers orchestration control plane REST API. It wraps HTTP requests to the Vers service using httpx, providing async methods to list, create, and manage virtual machines and related resources. The library handles authentication via API key, automatic retries with exponential backoff on transient failures, and structured error types for different HTTP status codes.

The package is designed for developers building applications that need to programmatically interact with a Vers orchestration cluster. It requires Python 3.10+ and is built on async/await patterns, making it suitable for concurrent workloads. Configuration is straightforward—API key and base URL can be set via constructor arguments or environment variables—and the client supports custom httpx.AsyncClient instances for advanced use cases.

Use it for:

- Automate VM provisioning and lifecycle management in a Vers cluster from Python applications.
- Build monitoring or management dashboards that query VM state and metrics via the Vers API.
- Integrate Vers orchestration into CI/CD pipelines or infrastructure-as-code workflows.
- Develop multi-tenant applications that dynamically allocate compute resources through Vers.
- Script bulk operations on VMs (creation, deletion, configuration) with automatic retry handling.

## Worth the install?

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

Provides async Python bindings to the Vers REST API for managing virtual machines and orchestration through the Vers control plane.

Yes, if you are actively using Vers and need a Python client. The library has low install friction, permissive licensing, no known vulnerabilities, and active maintenance. However, adoption appears early-stage (zero repository stars, recent first release in 2026-04-17), so evaluate whether Vers itself is stable and suitable for your use case before committing to this SDK.

## Install

pip install vers-sdk
uv add vers-sdk
poetry add vers-sdk

## Installing vers-sdk

Before you install: Low friction install with a single runtime dependency (httpx). Active maintenance as of 2026-06-19 with recent releases.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions.

Quickstart:

pip install vers-sdk

import asyncio
from vers_sdk import VersSdkClient

async def main():
    client = VersSdkClient(api_key="your-api-key")
    vms = await client.list_vms()
    print(vms.json())
    await client.close()

asyncio.run(main())

Requires Python 3.10 or later and an async runtime context.

Verify before relying:

- Actual adoption and stability of the Vers platform itself beyond download metrics.
- Quality and completeness of API coverage relative to the full Vers REST API surface.
- Community support or issue resolution velocity given the zero repository stars.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 2.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vers api client python, vm orchestration sdk, async rest api wrapper, vers control plane client, orchestrator api python, async-first, orchestration, rest-client

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