kc-sdk-python — Kvindo Cloud Python SDK
Official Python SDK / client for the Kvindo Cloud API — manage cloud infrastructure as code from Python: VMs, volumes, S3 object storage, Kubernetes, load balancers, VPCs, VPNs, and managed PostgreSQL.
A thin, typed client over the REST API: one resource client per resource type, all sharing the same create / read / update / delete / list contract.
Using Claude Code? This repo ships a Claude Code skill that teaches Claude how to script Kvindo Cloud with this SDK — clone this repo (or otherwise have it on disk) and open Claude Code there to pick it up automatically.
Install
pip install kc-sdk-python
Dependencies: requests, marshmallow-dataclass, py-ulid.
Usage
from kc_api import KcClient
client = KcClient("YOUR_API_TOKEN") # api_url defaults to https://cloud-api.kvindo.ru
# TLS certificate verification is on by default (verify_ssl=True). Pass
# verify_ssl=False only to point this SDK at a genuinely self-hosted instance
# with a self-signed cert.
# List (label-filtered, paginated)
resp = client.vms.get_by_labels({"env": "prod"}, max_page_size=50)
for vm in resp.resources:
print(vm["metadata"]["name"])
# Read one
vm = client.vms.read("01H...")
print(vm.resource)
# Create / update (async) then wait for it to reconcile
created = client.vms.create_or_update({
"metadata": {"name": "my-vm", "folderId": "01H..."},
"spec": {"offerId": "g3-1c2-100", "state": "running", ...},
})
status = client.vms.wait_request_satisfied(created.requestId, timeout_seconds=300)
assert status.succeeded
# Delete (optionally block until reconciled)
client.vms.delete("01H...", wait=True)
Create / update / delete are asynchronous: they return a requestId; poll
read_request(requestId) or use wait_request_satisfied(...). Every response
object carries errorMessage / errorCode (a typed KcApi*ErrorCode) which are
None on success.
Available resources
KcClient exposes one KcResourceClient per type, e.g. client.vms,
client.volumes, client.s3_buckets, client.kubernetes,
client.load_balancers, client.vpcs, client.postgresql_standalones,
client.folders, client.transactions, … (the surface mirrors the official
Kvindo Cloud API).
Related projects
Part of the Kvindo Cloud developer toolchain:
- kc CLI — kubectl-style command-line client for Kvindo Cloud.
- terraform-provider-kvindo — Terraform provider (Registry).
- Kvindo Cloud console — web UI and API.
- Claude Code skill — lets Claude script Kvindo Cloud with this SDK conversationally.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kc_sdk_python-3.1.0.tar.gz.
File metadata
- Download URL: kc_sdk_python-3.1.0.tar.gz
- Upload date:
- Size: 13.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
69f1811f19acd691521d3ffce53d43c58cb658ed0d3ce5e200b8d48cf3fa380b
|
|
| MD5 |
9f8855198cce01ac53bece6c807a0d36
|
|
| BLAKE2b-256 |
9cfced897d991a9120efd48925b14b0aeb3f68dc62f00cc6232b1c4cf1f47808
|
Provenance
The following attestation bundles were made for kc_sdk_python-3.1.0.tar.gz:
Publisher:
publish.yml on Kvindo/kc-sdk-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
kc_sdk_python-3.1.0.tar.gz -
Subject digest:
69f1811f19acd691521d3ffce53d43c58cb658ed0d3ce5e200b8d48cf3fa380b - Sigstore transparency entry: 2324698891
- Sigstore integration time:
-
Permalink:
Kvindo/kc-sdk-python@05b8faa611c7f5a52e7d0ca824a46d72f7297f5f -
Branch / Tag:
refs/tags/v3.1.0 - Owner: https://github.com/Kvindo
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@05b8faa611c7f5a52e7d0ca824a46d72f7297f5f -
Trigger Event:
push
-
Statement type:
File details
Details for the file kc_sdk_python-3.1.0-py3-none-any.whl.
File metadata
- Download URL: kc_sdk_python-3.1.0-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39b8ac9b23ce0a074a90546c16df12762671534e870d46d0a7151db5476e5119
|
|
| MD5 |
af712ee1c63f1d1b9c21d6f89adaaadf
|
|
| BLAKE2b-256 |
a952803fefaa3ca3a573bb295c2481503611d34591ecf21dc4a190d755138065
|
Provenance
The following attestation bundles were made for kc_sdk_python-3.1.0-py3-none-any.whl:
Publisher:
publish.yml on Kvindo/kc-sdk-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
kc_sdk_python-3.1.0-py3-none-any.whl -
Subject digest:
39b8ac9b23ce0a074a90546c16df12762671534e870d46d0a7151db5476e5119 - Sigstore transparency entry: 2324699046
- Sigstore integration time:
-
Permalink:
Kvindo/kc-sdk-python@05b8faa611c7f5a52e7d0ca824a46d72f7297f5f -
Branch / Tag:
refs/tags/v3.1.0 - Owner: https://github.com/Kvindo
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@05b8faa611c7f5a52e7d0ca824a46d72f7297f5f -
Trigger Event:
push
-
Statement type:
