lamia-cloud 0.1.0__tar.gz

lamia_cloud-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build setuptools-scm
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

lamia_cloud-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,28 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest

lamia_cloud-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.egg-info/
+dist/
+build/
+*.pyc
+.DS_Store
+.pytest_cache/
+.venv/
+src/_version.py

lamia_cloud-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sergey Sargsyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lamia_cloud-0.1.0/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: lamia-cloud
+Version: 0.1.0
+Summary: Cloud scheduling backend for Lamia — deploy and run .lm scripts on GCP.
+Author: Sergey Sargsyan
+License: MIT License
+        
+        Copyright (c) 2026 Sergey Sargsyan
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/lamia-lang/lamia-cloud
+Project-URL: Repository, https://github.com/lamia-lang/lamia-cloud
+Project-URL: Issues, https://github.com/lamia-lang/lamia-cloud/issues
+Keywords: lamia,cloud,scheduler,gcp,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lamia-lang>=0.1.0
+Requires-Dist: google-cloud-scheduler>=2.13.0
+Requires-Dist: google-cloud-build>=3.20.0
+Requires-Dist: google-cloud-run>=0.10.0
+Requires-Dist: google-cloud-storage>=2.14.0
+Requires-Dist: google-cloud-service-usage>=1.8.0
+Requires-Dist: google-cloud-resource-manager>=1.3.0
+Requires-Dist: pyyaml>=6.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
+Dynamic: license-file
+
+# lamia-cloud
+
+Cloud scheduling backend for [Lamia](https://github.com/lamia-lang/lamia). Deploy `.lm` scripts to run on a schedule in the cloud — fully automated. Currently supports GCP.
+
+## Installation
+
+```bash
+pip install "lamia-lang[cloud]"
+```
+
+## Prerequisites
+
+- GCP project with billing enabled
+- Application Default Credentials: `gcloud auth application-default login`
+
+All required GCP APIs (including Service Usage) are enabled automatically on first deploy.
+
+## Quick Start
+
+1. Add a `cloud` section to your project's `config.yaml`:
+
+```yaml
+cloud:
+  provider: gcp
+  project_id: my-gcp-project
+  location: us-central1  # optional, default: us-central1
+```
+
+2. Schedule your script with the `--remote` flag:
+
+```bash
+lamia schedule add my_script.lm --every day --remote
+```
+
+The `--remote` flag tells lamia to deploy and run the script in the cloud instead of locally.
+
+## Managing Schedules
+
+```bash
+lamia schedule list              # shows all jobs (local + cloud) with live status
+lamia schedule add X --remote    # deploy and schedule a new cloud job
+lamia schedule remove <id>       # tears down cloud resources and removes the job
+```
+
+## How It Works
+
+1. `lamia schedule add --remote` packages your project and deploys it as a Cloud Run service
+2. Cloud Scheduler triggers it on your cron schedule
+3. Logs are available in Cloud Logging
+4. `lamia schedule list` fetches live execution status from the cloud
+
+## LLM on Cloud — Vertex AI
+
+Scripts that use LLM calls run through **Vertex AI** on cloud. This gives you:
+
+- **No API keys** — authentication via IAM, no keys to store, rotate, or leak
+- **Budget control** — Vertex AI quotas and billing alerts
+- **Secure by default** — no API key transport or storage, traffic stays within GCP
+
+### Supported Models
+
+| Provider | Cloud routing |
+|----------|--------------|
+| **Anthropic** (Claude) | Runs natively on Vertex AI — same models, same quality |
+| **Google** (Gemini) | Runs natively on Vertex AI |
+| **OpenAI** (GPT, o-series) | Automatically mapped to Gemini by tier (strong/medium/light) with runtime selection of the best available current Gemini model |
+
+Anthropic and Google models run as-is. OpenAI models are mapped because they're not available on Vertex AI — tier classification is stable while the selected Gemini model is discovered dynamically at runtime.
+
+## Configuration Reference
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `cloud.provider` | Yes | — | Cloud provider (currently `gcp`) |
+| `cloud.project_id` | Yes | — | Your GCP project ID |
+| `cloud.location` | No | `us-central1` | Region for Cloud Run deployment |
+
+No environment variables are required.
+
+## Troubleshooting
+
+- If Vertex AI access is not enabled yet, lamia-cloud logs a project-specific URL and attempts to open it automatically in your browser:
+  `https://console.cloud.google.com/vertex-ai?project=<your-project-id>`
+- After accepting terms, re-run the schedule/install command once.
+
+## Development
+
+```bash
+git clone https://github.com/lamia-lang/lamia-cloud.git
+cd lamia-cloud
+pip install -e ".[dev]"
+pytest
+```
+
+## Releasing
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```

lamia_cloud-0.1.0/README.md

@@ -0,0 +1,100 @@
+# lamia-cloud
+
+Cloud scheduling backend for [Lamia](https://github.com/lamia-lang/lamia). Deploy `.lm` scripts to run on a schedule in the cloud — fully automated. Currently supports GCP.
+
+## Installation
+
+```bash
+pip install "lamia-lang[cloud]"
+```
+
+## Prerequisites
+
+- GCP project with billing enabled
+- Application Default Credentials: `gcloud auth application-default login`
+
+All required GCP APIs (including Service Usage) are enabled automatically on first deploy.
+
+## Quick Start
+
+1. Add a `cloud` section to your project's `config.yaml`:
+
+```yaml
+cloud:
+  provider: gcp
+  project_id: my-gcp-project
+  location: us-central1  # optional, default: us-central1
+```
+
+2. Schedule your script with the `--remote` flag:
+
+```bash
+lamia schedule add my_script.lm --every day --remote
+```
+
+The `--remote` flag tells lamia to deploy and run the script in the cloud instead of locally.
+
+## Managing Schedules
+
+```bash
+lamia schedule list              # shows all jobs (local + cloud) with live status
+lamia schedule add X --remote    # deploy and schedule a new cloud job
+lamia schedule remove <id>       # tears down cloud resources and removes the job
+```
+
+## How It Works
+
+1. `lamia schedule add --remote` packages your project and deploys it as a Cloud Run service
+2. Cloud Scheduler triggers it on your cron schedule
+3. Logs are available in Cloud Logging
+4. `lamia schedule list` fetches live execution status from the cloud
+
+## LLM on Cloud — Vertex AI
+
+Scripts that use LLM calls run through **Vertex AI** on cloud. This gives you:
+
+- **No API keys** — authentication via IAM, no keys to store, rotate, or leak
+- **Budget control** — Vertex AI quotas and billing alerts
+- **Secure by default** — no API key transport or storage, traffic stays within GCP
+
+### Supported Models
+
+| Provider | Cloud routing |
+|----------|--------------|
+| **Anthropic** (Claude) | Runs natively on Vertex AI — same models, same quality |
+| **Google** (Gemini) | Runs natively on Vertex AI |
+| **OpenAI** (GPT, o-series) | Automatically mapped to Gemini by tier (strong/medium/light) with runtime selection of the best available current Gemini model |
+
+Anthropic and Google models run as-is. OpenAI models are mapped because they're not available on Vertex AI — tier classification is stable while the selected Gemini model is discovered dynamically at runtime.
+
+## Configuration Reference
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `cloud.provider` | Yes | — | Cloud provider (currently `gcp`) |
+| `cloud.project_id` | Yes | — | Your GCP project ID |
+| `cloud.location` | No | `us-central1` | Region for Cloud Run deployment |
+
+No environment variables are required.
+
+## Troubleshooting
+
+- If Vertex AI access is not enabled yet, lamia-cloud logs a project-specific URL and attempts to open it automatically in your browser:
+  `https://console.cloud.google.com/vertex-ai?project=<your-project-id>`
+- After accepting terms, re-run the schedule/install command once.
+
+## Development
+
+```bash
+git clone https://github.com/lamia-lang/lamia-cloud.git
+cd lamia-cloud
+pip install -e ".[dev]"
+pytest
+```
+
+## Releasing
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```

lamia_cloud-0.1.0/lamia_cloud.egg-info/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: lamia-cloud
+Version: 0.1.0
+Summary: Cloud scheduling backend for Lamia — deploy and run .lm scripts on GCP.
+Author: Sergey Sargsyan
+License: MIT License
+        
+        Copyright (c) 2026 Sergey Sargsyan
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/lamia-lang/lamia-cloud
+Project-URL: Repository, https://github.com/lamia-lang/lamia-cloud
+Project-URL: Issues, https://github.com/lamia-lang/lamia-cloud/issues
+Keywords: lamia,cloud,scheduler,gcp,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lamia-lang>=0.1.0
+Requires-Dist: google-cloud-scheduler>=2.13.0
+Requires-Dist: google-cloud-build>=3.20.0
+Requires-Dist: google-cloud-run>=0.10.0
+Requires-Dist: google-cloud-storage>=2.14.0
+Requires-Dist: google-cloud-service-usage>=1.8.0
+Requires-Dist: google-cloud-resource-manager>=1.3.0
+Requires-Dist: pyyaml>=6.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
+Dynamic: license-file
+
+# lamia-cloud
+
+Cloud scheduling backend for [Lamia](https://github.com/lamia-lang/lamia). Deploy `.lm` scripts to run on a schedule in the cloud — fully automated. Currently supports GCP.
+
+## Installation
+
+```bash
+pip install "lamia-lang[cloud]"
+```
+
+## Prerequisites
+
+- GCP project with billing enabled
+- Application Default Credentials: `gcloud auth application-default login`
+
+All required GCP APIs (including Service Usage) are enabled automatically on first deploy.
+
+## Quick Start
+
+1. Add a `cloud` section to your project's `config.yaml`:
+
+```yaml
+cloud:
+  provider: gcp
+  project_id: my-gcp-project
+  location: us-central1  # optional, default: us-central1
+```
+
+2. Schedule your script with the `--remote` flag:
+
+```bash
+lamia schedule add my_script.lm --every day --remote
+```
+
+The `--remote` flag tells lamia to deploy and run the script in the cloud instead of locally.
+
+## Managing Schedules
+
+```bash
+lamia schedule list              # shows all jobs (local + cloud) with live status
+lamia schedule add X --remote    # deploy and schedule a new cloud job
+lamia schedule remove <id>       # tears down cloud resources and removes the job
+```
+
+## How It Works
+
+1. `lamia schedule add --remote` packages your project and deploys it as a Cloud Run service
+2. Cloud Scheduler triggers it on your cron schedule
+3. Logs are available in Cloud Logging
+4. `lamia schedule list` fetches live execution status from the cloud
+
+## LLM on Cloud — Vertex AI
+
+Scripts that use LLM calls run through **Vertex AI** on cloud. This gives you:
+
+- **No API keys** — authentication via IAM, no keys to store, rotate, or leak
+- **Budget control** — Vertex AI quotas and billing alerts
+- **Secure by default** — no API key transport or storage, traffic stays within GCP
+
+### Supported Models
+
+| Provider | Cloud routing |
+|----------|--------------|
+| **Anthropic** (Claude) | Runs natively on Vertex AI — same models, same quality |
+| **Google** (Gemini) | Runs natively on Vertex AI |
+| **OpenAI** (GPT, o-series) | Automatically mapped to Gemini by tier (strong/medium/light) with runtime selection of the best available current Gemini model |
+
+Anthropic and Google models run as-is. OpenAI models are mapped because they're not available on Vertex AI — tier classification is stable while the selected Gemini model is discovered dynamically at runtime.
+
+## Configuration Reference
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `cloud.provider` | Yes | — | Cloud provider (currently `gcp`) |
+| `cloud.project_id` | Yes | — | Your GCP project ID |
+| `cloud.location` | No | `us-central1` | Region for Cloud Run deployment |
+
+No environment variables are required.
+
+## Troubleshooting
+
+- If Vertex AI access is not enabled yet, lamia-cloud logs a project-specific URL and attempts to open it automatically in your browser:
+  `https://console.cloud.google.com/vertex-ai?project=<your-project-id>`
+- After accepting terms, re-run the schedule/install command once.
+
+## Development
+
+```bash
+git clone https://github.com/lamia-lang/lamia-cloud.git
+cd lamia-cloud
+pip install -e ".[dev]"
+pytest
+```
+
+## Releasing
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```

lamia_cloud-0.1.0/lamia_cloud.egg-info/SOURCES.txt

@@ -0,0 +1,29 @@
+.gitignore
+LICENSE
+README.md
+pyproject.toml
+.github/workflows/publish.yml
+.github/workflows/test.yml
+lamia_cloud.egg-info/PKG-INFO
+lamia_cloud.egg-info/SOURCES.txt
+lamia_cloud.egg-info/dependency_links.txt
+lamia_cloud.egg-info/entry_points.txt
+lamia_cloud.egg-info/requires.txt
+lamia_cloud.egg-info/top_level.txt
+src/__init__.py
+src/_version.py
+src/interfaces.py
+src/loader.py
+src/types.py
+src/gcp/__init__.py
+src/gcp/deployer.py
+src/gcp/scheduler.py
+src/gcp/vertex.py
+src/templates/Dockerfile
+src/templates/main.py
+tests/__init__.py
+tests/test_deployer.py
+tests/test_gcp.py
+tests/test_llm_adapter.py
+tests/test_loader.py
+tests/test_quickstart.py

lamia_cloud-0.1.0/lamia_cloud.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

lamia_cloud-0.1.0/lamia_cloud.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[lamia.cloud_providers]
+default = lamia_cloud:LamiaCloudProvider

lamia_cloud-0.1.0/lamia_cloud.egg-info/requires.txt

@@ -0,0 +1,12 @@
+lamia-lang>=0.1.0
+google-cloud-scheduler>=2.13.0
+google-cloud-build>=3.20.0
+google-cloud-run>=0.10.0
+google-cloud-storage>=2.14.0
+google-cloud-service-usage>=1.8.0
+google-cloud-resource-manager>=1.3.0
+pyyaml>=6.0.0
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.18.0

lamia_cloud-0.1.0/lamia_cloud.egg-info/top_level.txt

@@ -0,0 +1 @@
+lamia_cloud

lamia_cloud-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["setuptools>=45", "wheel", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lamia-cloud"
+dynamic = ["version"]
+description = "Cloud scheduling backend for Lamia — deploy and run .lm scripts on GCP."
+readme = "README.md"
+license = {file = "LICENSE"}
+requires-python = ">=3.10"
+keywords = ["lamia", "cloud", "scheduler", "gcp", "automation"]
+authors = [
+    {name = "Sergey Sargsyan"}
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+dependencies = [
+    "lamia-lang>=0.1.0",
+    "google-cloud-scheduler>=2.13.0",
+    "google-cloud-build>=3.20.0",
+    "google-cloud-run>=0.10.0",
+    "google-cloud-storage>=2.14.0",
+    "google-cloud-service-usage>=1.8.0",
+    "google-cloud-resource-manager>=1.3.0",
+    "pyyaml>=6.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.18.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/lamia-lang/lamia-cloud"
+Repository = "https://github.com/lamia-lang/lamia-cloud"
+Issues = "https://github.com/lamia-lang/lamia-cloud/issues"
+
+[project.entry-points."lamia.cloud_providers"]
+default = "lamia_cloud:LamiaCloudProvider"
+
+[tool.setuptools]
+package-dir = {"lamia_cloud" = "src", "lamia_cloud.gcp" = "src/gcp"}
+packages = ["lamia_cloud", "lamia_cloud.gcp"]
+
+[tool.setuptools.package-data]
+lamia_cloud = ["templates/*"]
+
+[tool.setuptools_scm]
+version_file = "src/_version.py"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"

lamia_cloud-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lamia_cloud-0.1.0/src/__init__.py

@@ -0,0 +1,59 @@
+"""lamia-cloud — lamia cloud services package.
+
+Public API:
+    get_cloud_llm() -> CloudLLM
+    get_scheduler(project_root) -> CloudScheduler
+    is_on_cloud() -> bool
+    Types: CloudLLMRequest, CloudLLMResponse, CloudScheduleJob, CloudJobStatus
+"""
+from lamia_cloud.interfaces import CloudLLM, CloudScheduler
+from lamia_cloud.types import CloudLLMRequest, CloudLLMResponse, CloudScheduleJob, CloudJobStatus
+from lamia_cloud.gcp import VertexLLM, is_on_gcp
+from lamia_cloud.loader import get_scheduler
+
+_llm_instance: CloudLLM = None
+
+
+def get_cloud_llm(region: str = "") -> CloudLLM:
+    """Return the cloud LLM instance.
+
+    Only GCP is supported, so we return VertexLLM directly without
+    conditional provider checking.
+    """
+    global _llm_instance
+    if _llm_instance is None:
+        _llm_instance = VertexLLM(region=region or _detect_region())
+    return _llm_instance
+
+
+def _detect_region() -> str:
+    """Auto-detect GCP region from Cloud Run metadata server."""
+    import urllib.request
+    try:
+        req = urllib.request.Request(
+            "http://metadata.google.internal/computeMetadata/v1/instance/region",
+            headers={"Metadata-Flavor": "Google"},
+        )
+        resp = urllib.request.urlopen(req, timeout=2)
+        full = resp.read().decode().strip()
+        return full.rsplit("/", 1)[-1]
+    except Exception:
+        return "us-central1"
+
+
+def is_on_cloud() -> bool:
+    """Check if running in a cloud environment."""
+    return is_on_gcp()
+
+
+__all__ = [
+    "CloudLLM",
+    "CloudScheduler",
+    "CloudLLMRequest",
+    "CloudLLMResponse",
+    "CloudScheduleJob",
+    "CloudJobStatus",
+    "get_cloud_llm",
+    "get_scheduler",
+    "is_on_cloud",
+]