feat(api): implement auto-download artifacts and fix CI configuration

- CI: Fix HF_TOKEN usage in GitHub Actions and add workflow_dispatch
- Docs: Update READMEs with Hugging Face Spaces metadata (Docker SDK, port 7860)
- API: Implement auto-download of ML artifacts from GitHub if missing locally
- API: Update Base Settings to resolve paths correctly in Docker/Local envs
- API: Standardize default port to 7860 and fix shutdown bug in ML system
- Deps: Add 'requests' dependency for artifact downloading"
- LICENSES

LICENSE.md

@@ -0,0 +1,102 @@
+# Creative Commons Attribution-NonCommercial 4.0 International License
+
+## CC BY-NC 4.0
+
+This work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.
+
+---
+
+## You are free to:
+
+**Share** — copy and redistribute the material in any medium or format
+
+**Adapt** — remix, transform, and build upon the material
+
+The licensor cannot revoke these freedoms as long as you follow the license terms.
+
+---
+
+## Under the following terms:
+
+### Attribution
+
+You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+
+**Required Attribution:**
+
+```reference
+Heart Disease Healthcare AI Systems, D0nG4667
+Licensed under CC BY-NC 4.0
+```
+
+### NonCommercial
+
+You may not use the material for commercial purposes.
+
+**Commercial purposes include, but are not limited to:**
+
+- Selling the code or derivatives as a product
+- Using the code in client work for profit
+- Creating paid courses or templates based on this code
+- Using in a commercial SaaS product
+- Using in a commercial healthcare application
+
+---
+
+## You CAN:
+
+- ✅ Use this code for **personal learning** and education
+- ✅ Use this code in your **portfolio** to showcase your skills
+- ✅ **Modify and adapt** the code for personal projects
+- ✅ **Share** your modifications (with proper attribution)
+- ✅ Use in **open-source** non-commercial projects
+- ✅ Use for **academic** and research purposes
+- ✅ Create **tutorials** and educational content referencing this code
+- ✅ Build upon this work for **non-commercial healthcare applications**
+
+---
+
+## You CANNOT:
+
+- ❌ **Sell** this code or any derivatives
+- ❌ Use in **commercial products** or services
+- ❌ Use for **paid client work**
+- ❌ Create **commercial courses** or tutorials based on this code
+- ❌ **Remove** or obscure the attribution to the original project
+- ❌ **Sublicense** or transfer the code to third parties for commercial use
+- ❌ Use in any **revenue-generating** application
+- ❌ Deploy this code in a **commercial healthcare service** without a separate commercial license
+
+---
+
+## No Warranty
+
+THIS 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.
+
+---
+
+## Full Legal Text
+
+To view a copy of this license, visit:
+[https://creativecommons.org/licenses/by-nc/4.0/legalcode](https://creativecommons.org/licenses/by-nc/4.0/legalcode)
+
+---
+
+## Summary
+
+This is a human-readable summary of (and not a substitute for) the [full license](https://creativecommons.org/licenses/by-nc/4.0/legalcode).
+
+**Key Points:**
+
+1. You must give credit to the Author- D0nG4667 of this repository
+2. You cannot use this for commercial purposes
+3. You can share and adapt the work for non-commercial use
+4. The same license terms apply to derivative works
+
+---
+
+Copyright (c) 2026 Diabetes Disease Outcome ML DL
+
+This work is licensed under a [Creative Commons Attribution-NonCommercial 4.0 International License](http://creativecommons.org/licenses/by-nc/4.0/).
+
+[![CC BY-NC 4.0](https://licensebuttons.net/l/by-nc/4.0/88x31.png)](http://creativecommons.org/licenses/by-nc/4.0/)

core/config.py

@@ -9,12 +9,8 @@ from pydantic_settings import BaseSettings, SettingsConfigDict
 
 # Let's assume the user wants the root of the "system" which is usually where artifacts might be or one level up.
 # Previous BASE_DIR was 'api' folder. ARTIFACTS_DIR was sibling to 'api'.
-ROOT_DIR = Path(__file__).resolve().parent.parent.parent.parent
-# If file is c:\...\api\core\config.py
-# parent -> core
-# parent.parent -> api
-# parent.parent.parent -> dl_system
-# parent.parent.parent.parent -> dl_system/api
+# api/core/config.py -> api/core -> api
+ROOT_DIR = Path(__file__).resolve().parent.parent
 
 NAMING_CONVENTION = "Deep Learning Diabetes Risk Prediction System"
 
@@ -51,6 +47,7 @@ class Settings(BaseSettings):
     # Paths
     # We define base directories as Path objects
     BASE_DIR: Path = ROOT_DIR
+    # These paths are relative to the API root
     ARTIFACTS_DIR: Path = BASE_DIR / "artifacts/dl"
     MODEL_DIR: Path = BASE_DIR / "models/dl"
     
@@ -62,6 +59,22 @@ class Settings(BaseSettings):
     THRESHOLD_FILENAME: str = "dl_threshold.json"
     BACKGROUND_DATA_FILENAME: str = "background_data.csv"
     
+    # Github URL
+    GITHUB_RAW_URL_BASE: str = "https://github.com/D0nG4667/Diabetes_Disease_Outcome_AI_System/raw/main"
+
+    @property
+    def ARTIFACT_URLS(self):
+        """Map local path properties to their remote URLs"""
+        return {
+            self.model_path_abs: f"{self.GITHUB_RAW_URL_BASE}/models/dl/{self.MODEL_FILENAME}",
+            self.scaler_path_abs: f"{self.GITHUB_RAW_URL_BASE}/models/dl/{self.SCALER_FILENAME}",
+            self.preprocessor_path_abs: f"{self.GITHUB_RAW_URL_BASE}/models/dl/{self.PREPROCESSOR_FILENAME}",
+            self.feature_creator_path_abs: f"{self.GITHUB_RAW_URL_BASE}/models/dl/{self.FEATURE_CREATOR_FILENAME}",
+            self.threshold_path_abs: f"{self.GITHUB_RAW_URL_BASE}/artifacts/dl/{self.THRESHOLD_FILENAME}",
+            self.background_data_path_abs: f"{self.GITHUB_RAW_URL_BASE}/artifacts/dl/{self.BACKGROUND_DATA_FILENAME}",
+        }
+
+    
     @property
     def model_path_abs(self) -> Path:
         return self.MODEL_DIR / self.MODEL_FILENAME

models/artifacts_loader.py

@@ -3,9 +3,13 @@ import pandas as pd
 import tensorflow as tf
 import logging
 import json
+from pathlib import Path
 from core.config import settings
 from core.exceptions import ArtifactLoadError
 from utils.temperature_scaling import TemperatureScaler
+import requests
+import shutil
+
 
 logger = logging.getLogger(__name__)
 
@@ -19,6 +23,23 @@ class ModelArtifacts:
         self.background_data = None
         self.is_loaded = False
 
+    def download_if_missing(self, path: Path, url: str):
+        if not path.exists():
+            logger.info(f"Downloading {path.name} from {url}...")
+            path.parent.mkdir(parents=True, exist_ok=True)
+            try:
+                response = requests.get(url, stream=True)
+                response.raise_for_status()
+                with open(path, 'wb') as f:
+                    shutil.copyfileobj(response.raw, f)
+                logger.info(f"Downloaded {path.name}")
+            except Exception as e:
+                logger.error(f"Failed to download {path.name}: {e}")
+                # We don't raise here, we let the load fail naturally or warn
+        else:
+            logger.info(f"Artifact {path.name} found locally. Skipping download.")
+
+
     def load_artifacts(self):
         """
         Loads all ML artifacts into memory.
@@ -28,7 +49,13 @@ class ModelArtifacts:
             return
 
         logger.info("Loading artifacts...")
+        
+        # Ensure all artifacts are present
+        for path, url in settings.ARTIFACT_URLS.items():
+            self.download_if_missing(path, url)
+
         try:
+
             # 1. Load Keras Model
             if not settings.model_path_abs.exists():
                 logger.warning(f"Model file not found at {settings.model_path_abs}. Skipping load.")

pyproject.toml

@@ -20,4 +20,5 @@ dependencies = [
     "shap>=0.49.1",
     "tensorflow>=2.20.0",
     "pydantic-settings>=2.0.0",
+    "requests>=2.32.5",
 ]

requirements.txt

@@ -13,3 +13,4 @@ scikit-learn>=1.8.0
 shap>=0.49.1
 tensorflow>=2.20.0
 pydantic-settings>=2.0.0
+requests>=2.32.3

uv.lock

@@ -70,6 +70,7 @@ dependencies = [
     { name = "pyarrow" },
     { name = "pydantic-settings" },
     { name = "python-dotenv" },
+    { name = "requests" },
     { name = "scikit-learn" },
     { name = "shap" },
     { name = "tensorflow" },
@@ -89,6 +90,7 @@ requires-dist = [
     { name = "pyarrow", specifier = ">=22.0.0" },
     { name = "pydantic-settings", specifier = ">=2.0.0" },
     { name = "python-dotenv", specifier = ">=1.2.1" },
+    { name = "requests", specifier = ">=2.32.5" },
     { name = "scikit-learn", specifier = ">=1.8.0" },
     { name = "shap", specifier = ">=0.49.1" },
     { name = "tensorflow", specifier = ">=2.20.0" },