refua-deploy 0.6.0__tar.gz

refua_deploy-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JJ Ben-Joseph
+
+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.

refua_deploy-0.6.0/PKG-INFO

@@ -0,0 +1,271 @@
+Metadata-Version: 2.4
+Name: refua-deploy
+Version: 0.6.0
+Summary: Deployment automation for Refua campaign workloads across private and public clouds.
+License-Expression: MIT
+License-File: LICENSE
+Keywords: drug discovery,machine learning,deployment,orchestration,kubernetes,refua
+Author: JJ Ben-Joseph
+Author-email: jj@tensorspace.ai
+Requires-Python: >=3.11,<3.14
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
+Requires-Dist: pyyaml (>=6.0.1)
+Project-URL: Documentation, https://github.com/agentcures/refua#readme
+Project-URL: Homepage, https://agentcures.com/
+Project-URL: Repository, https://github.com/agentcures/refua
+Description-Content-Type: text/markdown
+
+# refua-deploy
+
+`refua-deploy` generates deployment bundles for running Refua campaigns across public and private clouds.
+
+It integrates with sibling projects in this workspace:
+
+- `ClawCures`
+- `refua-mcp`
+
+When these projects are present, `refua-deploy` auto-detects their versions and uses matching default image tags.
+
+## Super Simple
+
+If you just want it working with sensible defaults:
+
+```bash
+cd refua-deploy
+poetry install
+poetry run refua-deploy init --output deploy.yaml --name refua-prod --visibility public --provider aws
+poetry run refua-deploy render --config deploy.yaml --output-dir dist
+bash dist/bootstrap/cluster-bootstrap.sh
+```
+
+What this does automatically:
+
+- Picks Kubernetes as orchestrator for public cloud.
+- Enables network auto-discovery and fills ingress/host/origin defaults.
+- Enables cluster bootstrap artifact generation.
+- Enables GPU `auto` mode by default.
+- Detects local `ClawCures` and `refua-mcp` versions for image tags.
+
+## Goals
+
+- Minimal required inputs.
+- Automatic network defaults.
+- Automatic cluster bootstrap artifacts.
+- GPU support that is transparent by default.
+
+## Features
+
+- Validated deployment config for:
+  - Public cloud providers: `aws`, `gcp`, `azure`, `oci`, `digitalocean`, `linode`, `vultr`, `hetzner`, `ibm`, `alibaba`, `scaleway`, `exoscale`
+  - Private cloud providers: `onprem`, `openstack`, `vmware`, `baremetal`, `proxmox`, `nutanix`
+- Runtime target selection:
+  - `kubernetes` renderer
+  - `compose` renderer
+- Automatic network inference:
+  - Ingress host from explicit config, env, or inferred metadata defaults
+  - Allowed hosts/origins inferred when omitted
+- Automatic bootstrap artifacts (Kubernetes targets):
+  - `bootstrap/cluster-bootstrap.sh`
+  - `bootstrap/metadata.auto.json`
+  - `bootstrap/network.auto.env`
+- Kubernetes bundle renderer:
+  - Namespace
+  - ConfigMap
+  - Secret templates
+  - Campaign output PVC
+  - `refua-mcp` Deployment + Service
+  - `ClawCures` CronJob
+  - Optional Ingress
+  - Optional NetworkPolicy
+  - `kustomization.yaml`
+- Compose bundle renderer:
+  - `refua_mcp` service
+  - `campaign_runner` service
+  - `.env.template`
+- GPU-aware deployment controls:
+  - `gpu.mode=auto` (default): GPU-friendly scheduling/runtime hints with CPU fallback.
+  - `gpu.mode=required`: hard GPU requests/limits for Kubernetes and `gpus: all` for Compose.
+  - `gpu.mode=off`: disables GPU behavior.
+- Plan output (`plan.json`) for CI/CD review and approvals.
+
+## Install
+
+```bash
+cd refua-deploy
+poetry install
+```
+
+## Quick Start
+
+Generate a starter config with maximum automation:
+
+```bash
+poetry run refua-deploy init \
+  --output deploy/public.yaml \
+  --name refua-oncology-prod \
+  --visibility public \
+  --provider aws \
+  --orchestrator kubernetes \
+  --provisioning-level auto \
+  --gpu-mode auto \
+  --gpu-vendor nvidia
+```
+
+Validate and preview plan:
+
+```bash
+poetry run refua-deploy plan \
+  --config deploy/public.yaml \
+  --output deploy/plan.json
+```
+
+Render artifacts:
+
+```bash
+poetry run refua-deploy render \
+  --config deploy/public.yaml \
+  --output-dir dist/public
+```
+
+Run generated bootstrap script:
+
+```bash
+bash dist/public/bootstrap/cluster-bootstrap.sh
+```
+
+Private cloud with compose:
+
+```bash
+poetry run refua-deploy init \
+  --output deploy/private.yaml \
+  --visibility private \
+  --provider onprem \
+  --orchestrator compose
+```
+
+Private cloud with Kubernetes (for example k3s/rke2):
+
+```bash
+poetry run refua-deploy init \
+  --output deploy/private-k8s.yaml \
+  --visibility private \
+  --provider vmware \
+  --orchestrator kubernetes
+```
+
+## Metadata Auto-Discovery
+
+`refua-deploy` can infer network/cluster context from:
+
+- Explicit config values (highest priority)
+- Environment variables
+- Cloud metadata endpoints (when enabled)
+
+Control flag:
+
+- `REFUA_DEPLOY_ENABLE_METADATA_HTTP=0` disables HTTP metadata probing.
+
+Useful environment overrides:
+
+- `REFUA_INGRESS_HOST`
+- `REFUA_PUBLIC_IP`
+- `REFUA_PRIVATE_IP`
+- `REFUA_AWS_VPC_ID`
+- `REFUA_AWS_SUBNET_IDS`
+- `REFUA_GCP_NETWORK`
+- `REFUA_GCP_SUBNETWORK`
+- `REFUA_AZURE_RESOURCE_GROUP`
+
+## Config Schema
+
+Top-level keys:
+
+- `name`
+- `cloud.visibility`
+- `cloud.provider`
+- `openclaw.base_url` (required)
+- `runtime`:
+  - `namespace`
+  - `orchestrator` (`kubernetes` or `compose`)
+  - `campaign`
+  - `mcp`
+- `kubernetes`:
+  - `distribution` (`eks`, `gke`, `aks`, `oke`, `doks`, `lke`, `vke`, `hke`, `iks`, `ack`, `ske`, `k3s`, `rke2`, `openshift`, `talos`, `kubeadm`, `generic`)
+  - `service_type` (`ClusterIP`, `NodePort`, `LoadBalancer`)
+  - `ingress_class`
+  - `storage_class`
+  - `create_network_policy`
+  - `namespace_annotations`
+- `gpu`:
+  - `mode` (`off`, `auto`, `required`)
+  - `vendor` (`nvidia`, `amd`, `intel`)
+  - `count`
+  - `resource_name`
+  - `mcp_enabled`
+  - `campaign_enabled`
+  - `node_selector`
+  - `toleration_key`
+- `automation`:
+  - `auto_discover_network`
+  - `bootstrap_cluster`
+  - `provisioning_level` (`manual`, `assisted`, `auto`)
+  - `cluster_name`
+  - `kubernetes_version`
+  - `node_count`
+  - `node_instance_type`
+  - `node_disk_gb`
+- `network`
+- `security`
+- `storage`
+
+Examples:
+
+- `examples/public_aws.yaml`
+- `examples/private_onprem.yaml`
+
+## Integration Details
+
+Generated artifacts follow existing Refua runtime contracts:
+
+- Campaign env vars:
+  - `REFUA_CAMPAIGN_OPENCLAW_BASE_URL`
+  - `REFUA_CAMPAIGN_OPENCLAW_MODEL`
+  - `REFUA_CAMPAIGN_TIMEOUT_SECONDS`
+  - `OPENCLAW_GATEWAY_TOKEN`
+- MCP runtime env vars:
+  - `REFUA_MCP_TRANSPORT`
+  - `REFUA_MCP_HOST`
+  - `REFUA_MCP_PORT`
+  - `REFUA_MCP_ALLOWED_HOSTS`
+  - `REFUA_MCP_ALLOWED_ORIGINS`
+  - `REFUA_MCP_AUTH_TOKENS`
+- GPU runtime env vars:
+  - `REFUA_GPU_MODE`
+  - `REFUA_GPU_VENDOR`
+  - `REFUA_GPU_COUNT`
+  - vendor hints like `CUDA_VISIBLE_DEVICES`, `NVIDIA_VISIBLE_DEVICES` where relevant
+
+## Development
+
+Run checks:
+
+```bash
+poetry run ruff check src tests
+poetry run mypy src
+poetry run pytest
+```
+
+Build package:
+
+```bash
+poetry build
+```
+

refua_deploy-0.6.0/README.md

@@ -0,0 +1,245 @@
+# refua-deploy
+
+`refua-deploy` generates deployment bundles for running Refua campaigns across public and private clouds.
+
+It integrates with sibling projects in this workspace:
+
+- `ClawCures`
+- `refua-mcp`
+
+When these projects are present, `refua-deploy` auto-detects their versions and uses matching default image tags.
+
+## Super Simple
+
+If you just want it working with sensible defaults:
+
+```bash
+cd refua-deploy
+poetry install
+poetry run refua-deploy init --output deploy.yaml --name refua-prod --visibility public --provider aws
+poetry run refua-deploy render --config deploy.yaml --output-dir dist
+bash dist/bootstrap/cluster-bootstrap.sh
+```
+
+What this does automatically:
+
+- Picks Kubernetes as orchestrator for public cloud.
+- Enables network auto-discovery and fills ingress/host/origin defaults.
+- Enables cluster bootstrap artifact generation.
+- Enables GPU `auto` mode by default.
+- Detects local `ClawCures` and `refua-mcp` versions for image tags.
+
+## Goals
+
+- Minimal required inputs.
+- Automatic network defaults.
+- Automatic cluster bootstrap artifacts.
+- GPU support that is transparent by default.
+
+## Features
+
+- Validated deployment config for:
+  - Public cloud providers: `aws`, `gcp`, `azure`, `oci`, `digitalocean`, `linode`, `vultr`, `hetzner`, `ibm`, `alibaba`, `scaleway`, `exoscale`
+  - Private cloud providers: `onprem`, `openstack`, `vmware`, `baremetal`, `proxmox`, `nutanix`
+- Runtime target selection:
+  - `kubernetes` renderer
+  - `compose` renderer
+- Automatic network inference:
+  - Ingress host from explicit config, env, or inferred metadata defaults
+  - Allowed hosts/origins inferred when omitted
+- Automatic bootstrap artifacts (Kubernetes targets):
+  - `bootstrap/cluster-bootstrap.sh`
+  - `bootstrap/metadata.auto.json`
+  - `bootstrap/network.auto.env`
+- Kubernetes bundle renderer:
+  - Namespace
+  - ConfigMap
+  - Secret templates
+  - Campaign output PVC
+  - `refua-mcp` Deployment + Service
+  - `ClawCures` CronJob
+  - Optional Ingress
+  - Optional NetworkPolicy
+  - `kustomization.yaml`
+- Compose bundle renderer:
+  - `refua_mcp` service
+  - `campaign_runner` service
+  - `.env.template`
+- GPU-aware deployment controls:
+  - `gpu.mode=auto` (default): GPU-friendly scheduling/runtime hints with CPU fallback.
+  - `gpu.mode=required`: hard GPU requests/limits for Kubernetes and `gpus: all` for Compose.
+  - `gpu.mode=off`: disables GPU behavior.
+- Plan output (`plan.json`) for CI/CD review and approvals.
+
+## Install
+
+```bash
+cd refua-deploy
+poetry install
+```
+
+## Quick Start
+
+Generate a starter config with maximum automation:
+
+```bash
+poetry run refua-deploy init \
+  --output deploy/public.yaml \
+  --name refua-oncology-prod \
+  --visibility public \
+  --provider aws \
+  --orchestrator kubernetes \
+  --provisioning-level auto \
+  --gpu-mode auto \
+  --gpu-vendor nvidia
+```
+
+Validate and preview plan:
+
+```bash
+poetry run refua-deploy plan \
+  --config deploy/public.yaml \
+  --output deploy/plan.json
+```
+
+Render artifacts:
+
+```bash
+poetry run refua-deploy render \
+  --config deploy/public.yaml \
+  --output-dir dist/public
+```
+
+Run generated bootstrap script:
+
+```bash
+bash dist/public/bootstrap/cluster-bootstrap.sh
+```
+
+Private cloud with compose:
+
+```bash
+poetry run refua-deploy init \
+  --output deploy/private.yaml \
+  --visibility private \
+  --provider onprem \
+  --orchestrator compose
+```
+
+Private cloud with Kubernetes (for example k3s/rke2):
+
+```bash
+poetry run refua-deploy init \
+  --output deploy/private-k8s.yaml \
+  --visibility private \
+  --provider vmware \
+  --orchestrator kubernetes
+```
+
+## Metadata Auto-Discovery
+
+`refua-deploy` can infer network/cluster context from:
+
+- Explicit config values (highest priority)
+- Environment variables
+- Cloud metadata endpoints (when enabled)
+
+Control flag:
+
+- `REFUA_DEPLOY_ENABLE_METADATA_HTTP=0` disables HTTP metadata probing.
+
+Useful environment overrides:
+
+- `REFUA_INGRESS_HOST`
+- `REFUA_PUBLIC_IP`
+- `REFUA_PRIVATE_IP`
+- `REFUA_AWS_VPC_ID`
+- `REFUA_AWS_SUBNET_IDS`
+- `REFUA_GCP_NETWORK`
+- `REFUA_GCP_SUBNETWORK`
+- `REFUA_AZURE_RESOURCE_GROUP`
+
+## Config Schema
+
+Top-level keys:
+
+- `name`
+- `cloud.visibility`
+- `cloud.provider`
+- `openclaw.base_url` (required)
+- `runtime`:
+  - `namespace`
+  - `orchestrator` (`kubernetes` or `compose`)
+  - `campaign`
+  - `mcp`
+- `kubernetes`:
+  - `distribution` (`eks`, `gke`, `aks`, `oke`, `doks`, `lke`, `vke`, `hke`, `iks`, `ack`, `ske`, `k3s`, `rke2`, `openshift`, `talos`, `kubeadm`, `generic`)
+  - `service_type` (`ClusterIP`, `NodePort`, `LoadBalancer`)
+  - `ingress_class`
+  - `storage_class`
+  - `create_network_policy`
+  - `namespace_annotations`
+- `gpu`:
+  - `mode` (`off`, `auto`, `required`)
+  - `vendor` (`nvidia`, `amd`, `intel`)
+  - `count`
+  - `resource_name`
+  - `mcp_enabled`
+  - `campaign_enabled`
+  - `node_selector`
+  - `toleration_key`
+- `automation`:
+  - `auto_discover_network`
+  - `bootstrap_cluster`
+  - `provisioning_level` (`manual`, `assisted`, `auto`)
+  - `cluster_name`
+  - `kubernetes_version`
+  - `node_count`
+  - `node_instance_type`
+  - `node_disk_gb`
+- `network`
+- `security`
+- `storage`
+
+Examples:
+
+- `examples/public_aws.yaml`
+- `examples/private_onprem.yaml`
+
+## Integration Details
+
+Generated artifacts follow existing Refua runtime contracts:
+
+- Campaign env vars:
+  - `REFUA_CAMPAIGN_OPENCLAW_BASE_URL`
+  - `REFUA_CAMPAIGN_OPENCLAW_MODEL`
+  - `REFUA_CAMPAIGN_TIMEOUT_SECONDS`
+  - `OPENCLAW_GATEWAY_TOKEN`
+- MCP runtime env vars:
+  - `REFUA_MCP_TRANSPORT`
+  - `REFUA_MCP_HOST`
+  - `REFUA_MCP_PORT`
+  - `REFUA_MCP_ALLOWED_HOSTS`
+  - `REFUA_MCP_ALLOWED_ORIGINS`
+  - `REFUA_MCP_AUTH_TOKENS`
+- GPU runtime env vars:
+  - `REFUA_GPU_MODE`
+  - `REFUA_GPU_VENDOR`
+  - `REFUA_GPU_COUNT`
+  - vendor hints like `CUDA_VISIBLE_DEVICES`, `NVIDIA_VISIBLE_DEVICES` where relevant
+
+## Development
+
+Run checks:
+
+```bash
+poetry run ruff check src tests
+poetry run mypy src
+poetry run pytest
+```
+
+Build package:
+
+```bash
+poetry build
+```

refua_deploy-0.6.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["poetry-core>=1.9.0"]
+build-backend = "poetry.core.masonry.api"
+
+[project]
+name = "refua-deploy"
+version = "0.6.0"
+description = "Deployment automation for Refua campaign workloads across private and public clouds."
+requires-python = ">=3.11,<3.14"
+authors = [{ name = "JJ Ben-Joseph", email = "jj@tensorspace.ai" }]
+license = "MIT"
+readme = "README.md"
+keywords = [
+    "drug discovery",
+    "machine learning",
+    "deployment",
+    "orchestration",
+    "kubernetes",
+    "refua",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Scientific/Engineering :: Bio-Informatics",
+]
+dependencies = ["pyyaml>=6.0.1"]
+
+[project.urls]
+Homepage = "https://agentcures.com/"
+Repository = "https://github.com/agentcures/refua"
+Documentation = "https://github.com/agentcures/refua#readme"
+
+[project.scripts]
+refua-deploy = "refua_deploy.cli:main"
+
+[tool.poetry]
+packages = [{ include = "refua_deploy", from = "src" }]
+
+[tool.poetry.group.dev.dependencies]
+pytest = ">=8.0.0"
+ruff = ">=0.6.0"
+mypy = ">=1.11.0"
+types-pyyaml = ">=6.0.12.20250915"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.mypy]
+python_version = "3.11"
+warn_unused_ignores = true
+disallow_untyped_defs = true
+check_untyped_defs = true
+strict_optional = true

refua_deploy-0.6.0/src/refua_deploy/__init__.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"