feat: cluster API support for Verda Cloud Python SDK #70

huksley · 2025-12-19T15:26:12Z

This adds support for running clusters using Verda Cloud official SDK.

Also fixing so the default BASE_URL is https://api.verda.com/v1

It is simple as follows:

ssh_key = verda_client.ssh_keys.get()[0]
cluster = verda_client.clusters.create(
    hostname='test-cluster',
    location=Locations.FIN_03,
    cluster_type='16H200',
    description='my machine learning cluster 2x8H200',
    image='ubuntu-22.04-cuda-12.4-cluster',
    ssh_key_ids=[ssh_key.id],
)

also implemented:

verda_client.clusters.is_available('16B200', Locations.FIN_03): bool
verda_client.clusters.get_availabilities(Locations.FIN_03): list[str]
verda_client.clusters.get_cluster_images('16B200'): list[str]

Implemented comprehensive support for the Clusters API: - Created ClustersService with methods for cluster management (create, get, delete, scale) - Added Cluster and ClusterNode dataclasses for type safety - Integrated clusters service into VerdaClient - Added ClusterStatus constants for cluster lifecycle management - Created comprehensive unit tests (13 tests covering all API operations) - Added detailed example demonstrating cluster operations - All tests pass (125/125)

verda/clusters/_clusters.py

tests/integration_tests/test_clusters.py

tamirse · 2025-12-22T12:06:36Z

tests/integration_tests/test_clusters.py

+        print(cluster)
+
+        # delete instance
+        # verda_client.clusters.action(cluster.id, 'delete')


can't delete really until it is running but this is 20 minutes wait usually

verda/_verda.py

examples/clusters_example.py

verda/clusters/_clusters.py

examples/clusters_example.py

verda/clusters/_clusters.py

Co-authored-by: Rakhim Davletkaliyev <rakhim@rakhim.org>

verda/clusters/_clusters.py

Co-authored-by: Rakhim Davletkaliyev <rakhim@rakhim.org>

verda/clusters/_clusters.py

freetonik

Some minor details

Co-authored-by: Rakhim Davletkaliyev <rakhim@rakhim.org>

verda/clusters/_clusters.py

tests/unit_tests/clusters/test_clusters.py

huksley requested a review from shamrin December 19, 2025 15:48

claude and others added 4 commits December 19, 2025 17:55

feat: clusters api

d6b9918

fix: unit test

814d02e

fix: polishing

99668e8

huksley force-pushed the feat/cluster-api branch from e956a7f to 99668e8 Compare December 19, 2025 15:55

Ruslan Gainutdinov added 2 commits December 22, 2025 11:08

fix: format, lint and unit test fixing

7f86615

fix: integration tests

471e089

huksley requested a review from tamirse December 22, 2025 10:01

tamirse reviewed Dec 22, 2025

View reviewed changes

Ruslan Gainutdinov added 4 commits December 22, 2025 17:00

fix: review fixes

f009010

fix: full features cluster example, add integration test

d2c3a04

fix: unit tests

f5c275c

fix: revert to the correct OS images in prod

7f9a1c5

huksley requested a review from tamirse December 23, 2025 07:39

shamrin requested changes Dec 31, 2025

View reviewed changes

verda/_verda.py Outdated Show resolved Hide resolved

examples/clusters_example.py Outdated Show resolved Hide resolved

verda/clusters/_clusters.py Show resolved Hide resolved

verda/clusters/_clusters.py Show resolved Hide resolved

shamrin added 5 commits December 31, 2025 13:47

remove "scale" verb

0a94fab

calling public API every 2 seconds is too much

4f52e85

add TODO comment about backoff logic reuse

f57532b

keyword-only args, optional description, order to match instances.create

1e53597

TODO comment in _instances module

f65b848

freetonik requested changes Dec 31, 2025

View reviewed changes