coreplexml 0.1.1__tar.gz

coreplexml-0.1.1/LICENSE

@@ -0,0 +1,28 @@
+Business Source License 1.1 (BUSL-1.1)
+
+Copyright (c) 2025 Rodrigo Henríquez and Intellicore TI SpA
+
+Use Limitation:
+This Licensed Work may only be used, copied, modified, or distributed for non-commercial purposes, including academic study, personal experimentation, and non-commercial research.
+
+Prohibited Uses:
+You may NOT use the Licensed Work or any derivative works for any commercial purpose, including offering a service to third parties, developing commercial products, or any internal commercial advantage, without explicit, written permission from Intellicore TI SpA.
+
+Change Date:
+There is currently no planned change date where this code will automatically switch to a more permissive license.
+
+Licensor:
+Intellicore TI SpA (contact@intellicore.cl)
+
+Primary Author:
+Rodrigo Henríquez (rodrigo@intellicore.cl)
+
+License Terms:
+The complete terms of the Business Source License 1.1 apply, as published by MariaDB Corporation Ab.
+
+A copy of the full license text can be found at:
+https://mariadb.com/bsl11
+
+Summary:
+You can use, view, modify, and share the code for non-commercial purposes freely. Commercial use requires obtaining a commercial license from Intellicore TI SpA.
+

coreplexml-0.1.1/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

coreplexml-0.1.1/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: coreplexml
+Version: 0.1.1
+Summary: Python SDK for CorePlexML AutoML & MLOps platform
+Home-page: https://coreplexml.io
+Author: Rodrigo Henríquez M. - Intellicore
+Author-email: r@coreplexml.io
+License: BUSL-1.1
+Project-URL: Platform, https://platform.coreplexml.io
+Project-URL: Documentation, https://platform.coreplexml.io/docs/site/
+Project-URL: Source, https://platform.coreplexml.io/sdk
+Keywords: automl mlops machine-learning h2o deployment monitoring
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# CorePlexML Python SDK
+
+Official Python client for the [CorePlexML](https://coreplexml.io) AutoML & MLOps platform.
+
+## Installation
+
+```bash
+pip install coreplexml
+```
+
+## Quick Start
+
+```python
+from coreplexml import CorePlexMLClient
+
+client = CorePlexMLClient(
+    base_url="https://platform.coreplexml.io",
+    api_key="your-api-key"
+)
+
+# List projects
+projects = client.projects.list()
+
+# Create a project
+project = client.projects.create(name="My ML Project")
+
+# Upload a dataset
+dataset = client.datasets.upload(
+    project_id=project["id"],
+    file_path="data.csv",
+    name="Training Data"
+)
+
+# Run an AutoML experiment
+experiment = client.experiments.create(
+    project_id=project["id"],
+    dataset_version_id=dataset["version_id"],
+    target_column="label",
+    problem_type="classification"
+)
+
+# Get the best model
+models = client.models.list(project_id=project["id"])
+best = models["items"][0]
+
+# Deploy
+deployment = client.deployments.create(
+    project_id=project["id"],
+    model_id=best["id"],
+    name="production-v1"
+)
+
+# Predict
+result = client.deployments.predict(
+    deployment_id=deployment["id"],
+    inputs={"feature1": 1.0, "feature2": "A"}
+)
+print(result["predictions"])
+```
+
+## Resources
+
+The client provides access to all platform resources:
+
+| Resource | Description |
+|----------|-------------|
+| `client.projects` | Project CRUD |
+| `client.datasets` | Dataset upload, versions, columns |
+| `client.experiments` | AutoML experiment management |
+| `client.models` | Model listing, metrics, explainability |
+| `client.deployments` | Deploy models, predict, A/B tests |
+| `client.reports` | Generate PDF/HTML reports |
+| `client.privacy` | Privacy Suite (PII detection, compliance) |
+| `client.synthgen` | Synthetic data generation (CTGAN, TVAE) |
+| `client.studio` | What-If analysis sessions |
+
+## Authentication
+
+Create an API key from **Profile > API Keys** in the platform, then:
+
+```python
+client = CorePlexMLClient(
+    base_url="https://platform.coreplexml.io",
+    api_key="cpx_your_api_key_here"
+)
+```
+
+## Error Handling
+
+```python
+from coreplexml import CorePlexMLClient, NotFoundError, ValidationError
+
+try:
+    client.projects.get("nonexistent-id")
+except NotFoundError:
+    print("Project not found")
+except ValidationError as e:
+    print(f"Validation error: {e}")
+```
+
+## Requirements
+
+- Python >= 3.9
+- `requests` >= 2.28
+
+## Links
+
+- [Platform](https://platform.coreplexml.io)
+- [API Documentation](https://platform.coreplexml.io/docs/site/)
+- [Website](https://coreplexml.io)
+
+## License
+
+Business Source License 1.1

coreplexml-0.1.1/README.md

@@ -0,0 +1,114 @@
+# CorePlexML Python SDK
+
+Official Python client for the [CorePlexML](https://coreplexml.io) AutoML & MLOps platform.
+
+## Installation
+
+```bash
+pip install coreplexml
+```
+
+## Quick Start
+
+```python
+from coreplexml import CorePlexMLClient
+
+client = CorePlexMLClient(
+    base_url="https://platform.coreplexml.io",
+    api_key="your-api-key"
+)
+
+# List projects
+projects = client.projects.list()
+
+# Create a project
+project = client.projects.create(name="My ML Project")
+
+# Upload a dataset
+dataset = client.datasets.upload(
+    project_id=project["id"],
+    file_path="data.csv",
+    name="Training Data"
+)
+
+# Run an AutoML experiment
+experiment = client.experiments.create(
+    project_id=project["id"],
+    dataset_version_id=dataset["version_id"],
+    target_column="label",
+    problem_type="classification"
+)
+
+# Get the best model
+models = client.models.list(project_id=project["id"])
+best = models["items"][0]
+
+# Deploy
+deployment = client.deployments.create(
+    project_id=project["id"],
+    model_id=best["id"],
+    name="production-v1"
+)
+
+# Predict
+result = client.deployments.predict(
+    deployment_id=deployment["id"],
+    inputs={"feature1": 1.0, "feature2": "A"}
+)
+print(result["predictions"])
+```
+
+## Resources
+
+The client provides access to all platform resources:
+
+| Resource | Description |
+|----------|-------------|
+| `client.projects` | Project CRUD |
+| `client.datasets` | Dataset upload, versions, columns |
+| `client.experiments` | AutoML experiment management |
+| `client.models` | Model listing, metrics, explainability |
+| `client.deployments` | Deploy models, predict, A/B tests |
+| `client.reports` | Generate PDF/HTML reports |
+| `client.privacy` | Privacy Suite (PII detection, compliance) |
+| `client.synthgen` | Synthetic data generation (CTGAN, TVAE) |
+| `client.studio` | What-If analysis sessions |
+
+## Authentication
+
+Create an API key from **Profile > API Keys** in the platform, then:
+
+```python
+client = CorePlexMLClient(
+    base_url="https://platform.coreplexml.io",
+    api_key="cpx_your_api_key_here"
+)
+```
+
+## Error Handling
+
+```python
+from coreplexml import CorePlexMLClient, NotFoundError, ValidationError
+
+try:
+    client.projects.get("nonexistent-id")
+except NotFoundError:
+    print("Project not found")
+except ValidationError as e:
+    print(f"Validation error: {e}")
+```
+
+## Requirements
+
+- Python >= 3.9
+- `requests` >= 2.28
+
+## Links
+
+- [Platform](https://platform.coreplexml.io)
+- [API Documentation](https://platform.coreplexml.io/docs/site/)
+- [Website](https://coreplexml.io)
+
+## License
+
+Business Source License 1.1

coreplexml-0.1.1/coreplexml/__init__.py

@@ -0,0 +1,21 @@
+"""CorePlexML Python SDK.
+
+A Python client for the CorePlexML AutoML & MLOps platform.
+Provides typed access to projects, datasets, experiments, models,
+deployments, reports, privacy suite, synthetic data generation,
+and what-if analysis.
+
+Quick start::
+
+    from coreplexml import CorePlexMLClient
+
+    client = CorePlexMLClient("https://your-domain.com", api_key="your-key")
+    projects = client.projects.list()
+
+Version: 0.1.1
+"""
+from coreplexml.client import CorePlexMLClient
+from coreplexml.exceptions import CorePlexMLError, AuthenticationError, NotFoundError, ValidationError
+
+__version__ = "0.1.1"
+__all__ = ["CorePlexMLClient", "CorePlexMLError", "AuthenticationError", "NotFoundError", "ValidationError", "__version__"]

coreplexml-0.1.1/coreplexml/_http.py

@@ -0,0 +1,157 @@
+from __future__ import annotations
+
+"""HTTP transport layer for the CorePlexML Python SDK.
+
+Provides low-level HTTP methods with automatic error handling,
+authentication, retry logic, and job polling support.
+"""
+
+import time
+import logging
+from typing import Any
+
+import requests
+from requests.adapters import HTTPAdapter
+from urllib3.util.retry import Retry
+
+from coreplexml.exceptions import CorePlexMLError, AuthenticationError, NotFoundError, ValidationError
+
+logger = logging.getLogger(__name__)
+
+_SDK_VERSION = "0.1.1"
+
+
+class HTTPClient:
+    """Low-level HTTP client with error handling, retries, and job polling."""
+
+    def __init__(self, base_url: str, api_key: str | None = None, timeout: int = 30):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.session = requests.Session()
+        self.session.headers["User-Agent"] = f"coreplexml-python/{_SDK_VERSION}"
+        self.session.headers["Content-Type"] = "application/json"
+        if api_key:
+            self.session.headers["Authorization"] = f"Bearer {api_key}"
+
+        # Retry transient failures with exponential backoff
+        retry = Retry(
+            total=3,
+            backoff_factor=0.5,
+            status_forcelist=[429, 500, 502, 503, 504],
+            allowed_methods=["GET", "PUT", "DELETE", "HEAD", "OPTIONS"],
+        )
+        adapter = HTTPAdapter(max_retries=retry)
+        self.session.mount("http://", adapter)
+        self.session.mount("https://", adapter)
+
+    def close(self) -> None:
+        """Close the underlying HTTP session and release connections."""
+        self.session.close()
+
+    def __repr__(self) -> str:
+        return f"HTTPClient(base_url={self.base_url!r})"
+
+    def _url(self, path: str) -> str:
+        return f"{self.base_url}{path}"
+
+    def _request(self, method: str, path: str, **kwargs) -> requests.Response:
+        """Execute HTTP request with connection error wrapping."""
+        kwargs.setdefault("timeout", self.timeout)
+        try:
+            return self.session.request(method, self._url(path), **kwargs)
+        except requests.exceptions.Timeout as e:
+            raise CorePlexMLError(f"Request timed out: {e}") from e
+        except requests.exceptions.ConnectionError as e:
+            raise CorePlexMLError(f"Connection failed: {e}") from e
+        except requests.exceptions.RequestException as e:
+            raise CorePlexMLError(f"Request failed: {e}") from e
+
+    def _handle_response(self, resp: requests.Response) -> dict:
+        """Process HTTP response and raise typed exceptions on errors."""
+        if resp.status_code == 204:
+            return {}
+        try:
+            data = resp.json()
+        except Exception:
+            text = resp.text[:500] if resp.text else "No response body"
+            data = {"detail": text}
+
+        if resp.status_code >= 400:
+            detail = data.get("detail", str(data)) if isinstance(data, dict) else str(data)
+            msg = f"HTTP {resp.status_code}: {detail}"
+            if resp.status_code in (401, 403):
+                raise AuthenticationError(msg, resp.status_code, detail)
+            elif resp.status_code == 404:
+                raise NotFoundError(msg, resp.status_code, detail)
+            elif resp.status_code == 422:
+                raise ValidationError(msg, resp.status_code, detail)
+            else:
+                raise CorePlexMLError(msg, resp.status_code, detail)
+        return data
+
+    def get(self, path: str, params: dict | None = None) -> dict:
+        """Send GET request."""
+        resp = self._request("GET", path, params=params)
+        return self._handle_response(resp)
+
+    def post(self, path: str, json: dict | None = None, files: dict | None = None) -> dict:
+        """Send POST request."""
+        if files:
+            saved_ct = self.session.headers.pop("Content-Type", None)
+            try:
+                resp = self._request("POST", path, data=json, files=files)
+            finally:
+                if saved_ct:
+                    self.session.headers["Content-Type"] = saved_ct
+        else:
+            resp = self._request("POST", path, json=json)
+        return self._handle_response(resp)
+
+    def put(self, path: str, json: dict | None = None) -> dict:
+        """Send PUT request."""
+        resp = self._request("PUT", path, json=json)
+        return self._handle_response(resp)
+
+    def patch(self, path: str, json: dict | None = None) -> dict:
+        """Send PATCH request."""
+        resp = self._request("PATCH", path, json=json)
+        return self._handle_response(resp)
+
+    def delete(self, path: str) -> dict:
+        """Send DELETE request."""
+        resp = self._request("DELETE", path)
+        return self._handle_response(resp)
+
+    def download(self, path: str, output_path: str, params: dict | None = None) -> str:
+        """Download a file from the API.
+
+        Returns:
+            The output_path where the file was saved.
+        """
+        resp = self._request("GET", path, params=params, stream=True)
+        if resp.status_code >= 400:
+            self._handle_response(resp)  # raises typed exception
+        with open(output_path, "wb") as f:
+            for chunk in resp.iter_content(chunk_size=8192):
+                f.write(chunk)
+        return output_path
+
+    def poll_job(self, job_id: str, interval: float = 3.0, timeout: float = 600.0) -> dict:
+        """Poll a job until completion or timeout."""
+        start = time.time()
+        while time.time() - start < timeout:
+            data = self.get(f"/api/jobs/{job_id}")
+            job = data.get("job", data) if isinstance(data, dict) else {}
+            status = job.get("status", "") if isinstance(job, dict) else ""
+            if status in ("succeeded", "completed", "failed", "error"):
+                return job if isinstance(job, dict) else data
+            time.sleep(interval)
+        raise CorePlexMLError(f"Job {job_id} timed out after {timeout}s")
+
+    def upload(self, path: str, file_path: str, fields: dict | None = None) -> dict:
+        """Upload a file via multipart form."""
+        import os
+        filename = os.path.basename(file_path)
+        with open(file_path, "rb") as f:
+            files = {"file": (filename, f)}
+            return self.post(path, json=fields, files=files)

coreplexml-0.1.1/coreplexml/client.py

@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+"""Main CorePlexML client."""
+
+from coreplexml._http import HTTPClient
+from coreplexml.projects import ProjectsResource
+from coreplexml.datasets import DatasetsResource
+from coreplexml.experiments import ExperimentsResource
+from coreplexml.models import ModelsResource
+from coreplexml.deployments import DeploymentsResource
+from coreplexml.reports import ReportsResource
+from coreplexml.privacy import PrivacyResource
+from coreplexml.synthgen import SynthGenResource
+from coreplexml.studio import StudioResource
+
+
+class CorePlexMLClient:
+    """Top-level client for the CorePlexML Python SDK.
+
+    Provides access to all API resources through typed sub-clients.
+
+    Args:
+        base_url: CorePlexML server URL (default ``http://localhost:8888``).
+        api_key: Bearer token for API authentication.
+        timeout: Request timeout in seconds (default 30).
+
+    Example::
+
+        from coreplexml import CorePlexMLClient
+
+        client = CorePlexMLClient("https://your-domain.com", api_key="your-key")
+        projects = client.projects.list()
+
+    Attributes:
+        projects: Manage projects.
+        datasets: Upload, list, and manage datasets.
+        experiments: Create and monitor AutoML experiments.
+        models: Get model info and make predictions.
+        deployments: Deploy models and manage production endpoints.
+        reports: Generate and download reports.
+        privacy: Privacy Suite -- PII detection and data transformation.
+        synthgen: Synthetic data generation with CTGAN/CopulaGAN/TVAE/Gaussian Copula.
+        studio: What-If Analysis -- scenario comparison.
+    """
+
+    def __init__(self, base_url: str = "http://localhost:8888", api_key: str | None = None, timeout: int = 30):
+        """Initialize the CorePlexML client.
+
+        Args:
+            base_url: Server URL (default ``http://localhost:8888``).
+            api_key: API key for Bearer authentication.
+            timeout: Request timeout in seconds.
+        """
+        self._http = HTTPClient(base_url, api_key=api_key, timeout=timeout)
+        self.projects = ProjectsResource(self._http)
+        self.datasets = DatasetsResource(self._http)
+        self.experiments = ExperimentsResource(self._http)
+        self.models = ModelsResource(self._http)
+        self.deployments = DeploymentsResource(self._http)
+        self.reports = ReportsResource(self._http)
+        self.privacy = PrivacyResource(self._http)
+        self.synthgen = SynthGenResource(self._http)
+        self.studio = StudioResource(self._http)
+
+    def close(self) -> None:
+        """Close the underlying HTTP session and release connections."""
+        self._http.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    def __repr__(self) -> str:
+        return f"CorePlexMLClient(base_url={self._http.base_url!r})"