anycloud Python SDK
Submit jobs, run workloads on any cloud.
Install
pip install anycloud-sdk
Quick start
import anycloud
ac = anycloud.Client()
job = ac.submit("my-training:latest", gpu="h100:8", env={"LR": "0.01"})
job.wait()
print(job.logs())
Chaining jobs
prep = ac.submit("prep:latest")
prep.wait()
train = ac.submit("train:latest", gpu="h100:8", env={"LR": "0.01"})
train.wait()
eval_job = ac.submit("eval:latest")
eval_job.wait()
Fan-out / fan-in
from anycloud import Submission
split = ac.submit("split:latest")
split.wait()
shards = ac.submit_many([
Submission(image="worker:latest", env={"LR": lr})
for lr in ["0.1", "0.01", "0.001"]
])
shards.wait()
merge = ac.submit("merge:latest")
merge.wait()
Decorator (run a Python function remotely)
Skip the image-build loop — decorate a function, and AnyCloud clones your repo on the remote VM:
@anycloud.function(image="ghcr.io/acme/trainer:latest", gpu="h100:8")
def train(lr: float):
...
jobs = train.map([0.1, 0.01, 0.001]) # fan out across args
jobs.wait()
Decorator deployments clone your committed, pushed GitHub repo on the remote VM. Private repos work after anycloud login, or with GITHUB_TOKEN set to a token with repo read access. The image must include git. See reference.
Serve decorator (run a long-lived daemon)
Use @anycloud.serve for one long-running server process with a stable URL:
import os
import anycloud
@anycloud.serve(image="ghcr.io/acme/inference:latest", gpu="L40S:1")
def node():
import uvicorn
from myapp import app
uvicorn.run(app, host="0.0.0.0", port=int(os.environ["PORT"]))
server = node.start(id="model-a-001")
server.wait_running(timeout=600)
print(server.url)
The entrypoint must block. AnyCloud sets PORT=8088 by default; override it with env={"PORT": "<port>"}. The public URL is https://<deployment-id>.anycloud.sh. @anycloud.serve uses the same private-repo git-clone authentication as @anycloud.function.
The live SDK e2e suite includes serve-decorator coverage:
bash test/integration/e2e.sh sdk-python-serve
When a remote function fails, DeploymentFailedError.logs includes the labeled bootstrap error:
from anycloud import DeploymentFailedError
try:
train.submit(0.01).wait()
except DeploymentFailedError as e:
print(e.state, e.logs)
Buckets
Chain data between jobs using bucket handles. Output buckets are auto-created by the server; upload() auto-creates input buckets.
data = ac.bucket("training-data")
model = ac.bucket("model-output")
data.upload("~/datasets/imagenet") # auto-creates bucket
prep = ac.submit("prep:latest", input=data, output=model)
prep.wait()
train = ac.submit("train:latest", input=model, output=model, gpu="h100:8")
train.wait()
model.download("~/checkpoints/")
Bucket I/O streams through the local anycloud api server using a credential registered with anycloud credentials new — no extra installs needed. Use Client(credentials="<name>") so the SDK knows which credential to pass.
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 anycloud_sdk-0.1.36.tar.gz.
File metadata
- Download URL: anycloud_sdk-0.1.36.tar.gz
- Upload date:
- Size: 43.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e478f24580a52802acd6beafdc7a02465784784e97cb2101c32382a8d940728
|
|
| MD5 |
2a62b909d7a8cce419be331e2a56da58
|
|
| BLAKE2b-256 |
168ef75ea1fa8c8c8665e6bcc7a1f890ab59e4dbb80aa0dec449a79c4265b734
|
Provenance
The following attestation bundles were made for anycloud_sdk-0.1.36.tar.gz:
Publisher:
release.yml on anycloud-sh/anycloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
anycloud_sdk-0.1.36.tar.gz -
Subject digest:
2e478f24580a52802acd6beafdc7a02465784784e97cb2101c32382a8d940728 - Sigstore transparency entry: 2012721533
- Sigstore integration time:
-
Permalink:
anycloud-sh/anycloud@b604c07cef0a5157ed909020354d42df2eea1dd2 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/anycloud-sh
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@b604c07cef0a5157ed909020354d42df2eea1dd2 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file anycloud_sdk-0.1.36-py3-none-any.whl.
File metadata
- Download URL: anycloud_sdk-0.1.36-py3-none-any.whl
- Upload date:
- Size: 29.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca8e531004717e8bc652d1dbd537893a0b21d9fb65b8d6b3de1f4cbac55e1c7a
|
|
| MD5 |
592d20efda64aa9d073535d6b326f91b
|
|
| BLAKE2b-256 |
f211bb7a8a85dd86113d7c6c2bc706ae0a0cc0e5bd7af563bbfe37d7878b3b01
|
Provenance
The following attestation bundles were made for anycloud_sdk-0.1.36-py3-none-any.whl:
Publisher:
release.yml on anycloud-sh/anycloud
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
anycloud_sdk-0.1.36-py3-none-any.whl -
Subject digest:
ca8e531004717e8bc652d1dbd537893a0b21d9fb65b8d6b3de1f4cbac55e1c7a - Sigstore transparency entry: 2012721591
- Sigstore integration time:
-
Permalink:
anycloud-sh/anycloud@b604c07cef0a5157ed909020354d42df2eea1dd2 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/anycloud-sh
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@b604c07cef0a5157ed909020354d42df2eea1dd2 -
Trigger Event:
workflow_dispatch
-
Statement type:
