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

Discover storage, inspect objects, and chain data between jobs using bucket handles. Select a credential saved with anycloud credentials new:

ac = anycloud.Client(credentials="aws-prod")

for bucket in ac.list_buckets():
    print(bucket.name, bucket.region, bucket.created_at)

data  = ac.bucket("training-data")
model = ac.bucket("model-output")

data.upload("~/datasets/imagenet.tar", remote_path="datasets/imagenet.tar")
data.upload_directory("~/datasets/shards", prefix="datasets/shards/")

for entry in data.list_objects(prefix="datasets/"):
    print(entry.kind, entry.key, entry.size_bytes)

all_objects = data.list_objects(recursive=True, limit=None)

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_directory("~/checkpoints", prefix="checkpoints/")

Listings default to 1,000 sorted results; limit=None exhausts every API page. Prefixes are literal, so include a trailing / to browse a folder. Bucket I/O and listing stream through the local anycloud api server—no provider SDK extras are needed. Input buckets must already exist; output buckets used by a Job can be created by the server.

Downloads validate the received byte count and atomically replace the target only after a complete response. Incomplete responses are retried twice, then raise DownloadIntegrityError while preserving any existing target.

Directory upload, download, and prefix deletion use four workers by default; pass concurrency=1 through 32 to tune the bound. They return a BucketOperationResult. Partial item failures raise BucketOperationError with the result summary and ordered (object_key, exception) failures.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

anycloud_sdk-0.1.58.tar.gz (57.3 kB view details)

Uploaded Aug 15, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

anycloud_sdk-0.1.58-py3-none-any.whl (36.7 kB view details)

Uploaded Aug 15, 2026 Python 3

File details

Details for the file anycloud_sdk-0.1.58.tar.gz.

File metadata

Download URL: anycloud_sdk-0.1.58.tar.gz
Upload date: Aug 15, 2026
Size: 57.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for anycloud_sdk-0.1.58.tar.gz
Algorithm	Hash digest
SHA256	`71ddeddeb1e1827a45c523de4c02196d7a3c5b4c79db684db86a5e15903bda60`
MD5	`de767f88c588d4d4fb1edfc80f8e70be`
BLAKE2b-256	`b7f8a571aced6426c8f1ef4d82425a994d8646f7affc4408e937629a818bc9da`

See more details on using hashes here.

Provenance

The following attestation bundles were made for anycloud_sdk-0.1.58.tar.gz:

Publisher: release.yml on anycloud-sh/anycloud

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: anycloud_sdk-0.1.58.tar.gz
- Subject digest: 71ddeddeb1e1827a45c523de4c02196d7a3c5b4c79db684db86a5e15903bda60
- Sigstore transparency entry: 2470892816
- Sigstore integration time: Aug 15, 2026
Source repository:
- Permalink: anycloud-sh/anycloud@1c5156b9f6816795d8ae3526daadb283354b6b81
- Branch / Tag: refs/heads/main
- Owner: https://github.com/anycloud-sh
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@1c5156b9f6816795d8ae3526daadb283354b6b81
- Trigger Event: workflow_dispatch