aimodelshare 0.3.7__py3-none-any.whl

aimodelshare/README.md

@@ -0,0 +1,26 @@
+<p align="center"><img width="40%" src="https://github.com/AIModelShare/aimodelshare/blob/master/docs/aimodshare_banner.jpg" /></p>
+
+### The mission of the AI Model Share Platform is to provide a trusted non profit repository for machine learning model prediction APIs (python library + integrated website at modelshare.org).  A beta version of the platform is currently being used by Columbia University students, faculty, and staff to test and improve platform functionality.
+
+### In a matter of seconds, data scientists can launch a model into this infrastructure and end-users the world over will be able to engage their machine learning models.
+
+* ***Launch machine learning models into scalable production ready prediction REST APIs using a single Python function.*** 
+
+* ***Details about each model, how to use the model's API, and the model's author(s) are deployed simultaneously into a searchable website at modelshare.org.*** 
+
+* ***Deployed models receive an individual Model Playground listing information about all deployed models. Each of these pages includes a fully functional prediction dashboard that allows end-users to input text, tabular, or image data and receive live predictions.*** 
+
+* ***Moreover, users can build on model playgrounds by 1) creating ML model competitions, 2) uploading Jupyter notebooks to share code, 3) sharing model architectures and 4) sharing data... with all shared artifacts automatically creating a data science user portfolio.*** 
+
+# Use aimodelshare Python library to deploy your model, create a new ML competition, and more.
+* [Tutorials for deploying models](https://www.modelshare.org/search/deploy?search=ALL&problemdomain=ALL&gettingstartedguide=TRUE&pythonlibrariesused=ALL&tags=ALL&pageNum=1).
+
+# Find model playground web-dashboards to generate predictions now.
+* [View deployed models and generate predictions at modelshare.org](https://www.modelshare.org)
+
+# Installation
+
+You can then install aimodelshare from PyPi
+```
+pip install aimodelshare
+```

aimodelshare/__init__.py

@@ -0,0 +1,100 @@
+"""
+Top-level aimodelshare package initializer.
+
+Refactored to:
+- Avoid eager importing of heavy optional dependencies (networkx, torch, tensorflow, etc.)
+- Allow lightweight submodules (e.g. aimodelshare.moral_compass) to work in minimal environments.
+- Preserve backward compatibility where possible without forcing heavy installs.
+"""
+
+from importlib import import_module
+import warnings
+
+__all__ = [
+    # Heavy/high-level objects (added only if imported successfully)
+    "ModelPlayground",
+    "Competition",
+    "Data",
+    "Experiment",
+    # Preprocessor helpers (optional)
+    "upload_preprocessor",
+    "import_preprocessor",
+    "export_preprocessor",
+    # Moral Compass client (lightweight)
+    "MoralcompassApiClient",
+    "MoralcompassTableMeta",
+    "MoralcompassUserStats",
+    "ApiClientError",
+    "NotFoundError",
+    "ServerError",
+    "get_api_base_url",
+]
+
+def _safe_import(module_name, symbols, remove_if_missing=True):
+    """
+    Attempt to import given symbols from module_name.
+    On failure, emit a warning and optionally remove them from __all__.
+    """
+    try:
+        mod = import_module(module_name)
+        for sym in symbols:
+            try:
+                globals()[sym] = getattr(mod, sym)
+            except AttributeError:
+                warnings.warn(
+                    f"aimodelshare: symbol '{sym}' not found in module '{module_name}'."
+                )
+                if remove_if_missing and sym in __all__:
+                    __all__.remove(sym)
+    except Exception as exc:
+        warnings.warn(
+            f"aimodelshare: optional module '{module_name}' not loaded ({exc}). "
+            "Lightweight submodules remain usable."
+        )
+        if remove_if_missing:
+            for sym in symbols:
+                if sym in __all__ and sym not in globals():
+                    __all__.remove(sym)
+
+# Attempt optional imports (silently skip if deps missing)
+_safe_import(
+    "aimodelshare.playground",
+    ["ModelPlayground", "Competition", "Experiment", "Data"],
+)
+
+_safe_import(
+    "aimodelshare.preprocessormodules",
+    ["export_preprocessor", "upload_preprocessor", "import_preprocessor"],
+)
+
+# DO NOT IMPORT download_data or import_quickstart_data HERE
+# Instead, provide a lazy loader for download_data only when accessed
+
+def _lazy_download_data(*args, **kwargs):
+    # Import only when called
+    mod = import_module("aimodelshare.data_sharing.download_data")
+    return mod.download_data(*args, **kwargs)
+
+# Expose lazy loader as attribute (optional)
+download_data = _lazy_download_data
+# DO NOT expose import_quickstart_data at this level, recommend direct import
+
+# Moral Compass submodule (expected always present in new branch)
+_safe_import(
+    "aimodelshare.moral_compass",
+    [
+        "MoralcompassApiClient",
+        "MoralcompassTableMeta",
+        "MoralcompassUserStats",
+        "ApiClientError",
+        "NotFoundError",
+        "ServerError",
+        "get_api_base_url",
+    ],
+    remove_if_missing=False,  # If this fails, keep names so import errors surface clearly later
+)
+
+# Ensure __all__ only contains names actually available (except intentional exposure for debug)
+__all__ = [name for name in __all__ if name in globals()]
+if "download_data" not in __all__:
+    __all__.append("download_data")  # Only if you want aimodelshare.download_data available