anycloud-sdk 0.1.3__tar.gz

anycloud_sdk-0.1.3/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.pytest_cache/

anycloud_sdk-0.1.3/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: anycloud-sdk
+Version: 0.1.3
+Summary: Python SDK for anycloud — submit jobs, run workloads on any cloud
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Provides-Extra: all
+Requires-Dist: adlfs>=2024.0; extra == 'all'
+Requires-Dist: gcsfs>=2024.0; extra == 'all'
+Requires-Dist: s3fs>=2024.0; extra == 'all'
+Provides-Extra: aws
+Requires-Dist: s3fs>=2024.0; extra == 'aws'
+Provides-Extra: azure
+Requires-Dist: adlfs>=2024.0; extra == 'azure'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Provides-Extra: gcp
+Requires-Dist: gcsfs>=2024.0; extra == 'gcp'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# anycloud Python SDK
+
+Submit jobs, run workloads on any cloud.
+
+## Install
+
+```bash
+pip install anycloud-sdk
+```
+
+For the latest pre-release version:
+
+```bash
+pip install --pre anycloud-sdk
+```
+
+## Quick start
+
+```python
+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
+
+```python
+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
+
+```python
+from anycloud import JobGroup
+
+split = ac.submit("split:latest")
+split.wait()
+
+shards = JobGroup([ac.submit("worker:latest", env={"LR": lr}) for lr in ["0.1", "0.01", "0.001"]])
+shards.wait_all()
+
+merge = ac.submit("merge:latest")
+merge.wait()
+```
+
+## Buckets
+
+Chain data between jobs using bucket handles. Output buckets are auto-created by the server; `upload()` auto-creates input buckets.
+
+```python
+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/")
+```
+
+Install with the cloud extra for your provider: `pip install anycloud-sdk[aws]` (or `[gcp]`, `[azure]`, `[all]`).

anycloud_sdk-0.1.3/README.md

@@ -0,0 +1,76 @@
+# anycloud Python SDK
+
+Submit jobs, run workloads on any cloud.
+
+## Install
+
+```bash
+pip install anycloud-sdk
+```
+
+For the latest pre-release version:
+
+```bash
+pip install --pre anycloud-sdk
+```
+
+## Quick start
+
+```python
+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
+
+```python
+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
+
+```python
+from anycloud import JobGroup
+
+split = ac.submit("split:latest")
+split.wait()
+
+shards = JobGroup([ac.submit("worker:latest", env={"LR": lr}) for lr in ["0.1", "0.01", "0.001"]])
+shards.wait_all()
+
+merge = ac.submit("merge:latest")
+merge.wait()
+```
+
+## Buckets
+
+Chain data between jobs using bucket handles. Output buckets are auto-created by the server; `upload()` auto-creates input buckets.
+
+```python
+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/")
+```
+
+Install with the cloud extra for your provider: `pip install anycloud-sdk[aws]` (or `[gcp]`, `[azure]`, `[all]`).

anycloud_sdk-0.1.3/anycloud/__init__.py

@@ -0,0 +1,56 @@
+"""anycloud Python SDK — submit jobs, run workloads on any cloud."""
+
+from anycloud.client import Client
+from anycloud.function import Function, function
+from anycloud.image import Image
+from anycloud.errors import (
+    AnyCloudError,
+    APIError,
+    ConflictError,
+    JobFailedError,
+    JobGroupError,
+    NotFoundError,
+    TimeoutError,
+)
+from anycloud.job import Job
+from anycloud.job_group import JobGroup
+from anycloud.storage import Bucket
+from anycloud.types import (
+    AWSCredentials,
+    AzureCredentials,
+    CloudConfig,
+    CloudType,
+    Deployment,
+    DeploymentState,
+    DockerOptions,
+    GCPCredentials,
+    LambdaCredentials,
+)
+
+__all__ = [
+    "Client",
+    "function",
+    "Function",
+    "Image",
+    "Job",
+    "JobGroup",
+    "Bucket",
+    # Types
+    "CloudConfig",
+    "CloudType",
+    "Deployment",
+    "DeploymentState",
+    "DockerOptions",
+    "AWSCredentials",
+    "GCPCredentials",
+    "AzureCredentials",
+    "LambdaCredentials",
+    # Errors
+    "AnyCloudError",
+    "APIError",
+    "ConflictError",
+    "JobFailedError",
+    "JobGroupError",
+    "NotFoundError",
+    "TimeoutError",
+]

anycloud_sdk-0.1.3/anycloud/build-defaults.json

@@ -0,0 +1,6 @@
+{
+  "AWS": { "vmType": "c5.xlarge", "region": "us-east-1" },
+  "GCP": { "vmType": "n2-standard-4", "region": "us-east4" },
+  "Azure": { "vmType": "Standard_D4s_v3", "region": "eastus" },
+  "Lambda": { "vmType": "cpu_4x_general", "region": "us-east-1" }
+}