User Feedback: Heavy install footprint (#139)

Author: sureshcsdp

.github/workflows/docker-publish.yml

@@ -66,7 +66,9 @@ jobs:
           platforms: linux/amd64,linux/arm64
           push: true
           tags: ${{ steps.meta.outputs.tags }}
-          build-args: CLEANCLOUD_VERSION=${{ steps.version.outputs.CLEANCLOUD_VERSION }}
+          build-args: |
+            CLEANCLOUD_VERSION=${{ steps.version.outputs.CLEANCLOUD_VERSION }}
+            CLEANCLOUD_EXTRAS=all
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
           cache-to: type=gha,mode=max

.github/workflows/main-validation.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
 #      - name: Verify imports
 #        run: |
@@ -61,7 +61,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       # AWS via OIDC (no static secrets)
       - name: Configure AWS credentials (OIDC)
@@ -104,7 +104,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       - name: Configure AWS credentials (OIDC)
         uses: aws-actions/configure-aws-credentials@v4
@@ -146,7 +146,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       - name: Azure Login via OIDC
         uses: azure/login@v2
@@ -191,7 +191,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       - name: Azure Login via OIDC (no subscription pin — scans all)
         uses: azure/login@v2
@@ -233,7 +233,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       - name: Authenticate to GCP (Workload Identity Federation)
         uses: google-github-actions/auth@v2

.github/workflows/pr-checks.yml

@@ -59,7 +59,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       # AWS via OIDC (no static secrets)
       - name: Configure AWS credentials (OIDC)
@@ -149,7 +149,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       # AWS via OIDC (matches client CI usage)
       - name: Configure AWS credentials (OIDC)
@@ -194,7 +194,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       - name: Configure AWS credentials (OIDC)
         uses: aws-actions/configure-aws-credentials@v4
@@ -235,7 +235,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       - name: Azure Login via OIDC
         uses: azure/login@v2
@@ -281,7 +281,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       - name: Azure Login via OIDC (no subscription pin — scans all)
         uses: azure/login@v2
@@ -322,7 +322,7 @@ jobs:
       - name: Install CleanCloud
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+          pip install -e ".[all,dev]"
 
       - name: Authenticate to GCP (Workload Identity Federation)
         uses: google-github-actions/auth@v2

CONTRIBUTING.md

@@ -53,9 +53,8 @@ cd cleancloud
 python -m venv venv
 source venv/bin/activate  # On Windows: venv\Scripts\activate
 
-# Install dependencies
-pip install -e .
-pip install -r requirements-dev.txt  # If exists
+# Install with all cloud SDKs and dev dependencies
+pip install -e '.[all,dev]'
 ```
 
 ### 3. Run Tests

Dockerfile

@@ -8,10 +8,11 @@ RUN apk update && apk upgrade && rm -rf /var/cache/apk/* \
     && pip install --upgrade pip
 
 ARG CLEANCLOUD_VERSION
+ARG CLEANCLOUD_EXTRAS=all
 RUN if [ -n "${CLEANCLOUD_VERSION}" ]; then \
-        pip install cleancloud==${CLEANCLOUD_VERSION}; \
+        pip install "cleancloud[${CLEANCLOUD_EXTRAS}]==${CLEANCLOUD_VERSION}"; \
     else \
-        pip install cleancloud; \
+        pip install "cleancloud[${CLEANCLOUD_EXTRAS}]"; \
     fi
 
 ENTRYPOINT ["cleancloud"]

README.fr.md

@@ -22,18 +22,16 @@ CleanCloud vous indique exactement ce qu'il faut supprimer dans votre cloud —
 ## Démarrage rapide
 
 ```bash
+# Essayez sans credentials :
 pipx install cleancloud
-cleancloud demo                      # visualisez des findings — aucun credential requis
-cleancloud demo --category ai        # findings IA/ML (SageMaker, AML, Vertex AI)
-```
-
-Scannez votre cloud :
+cleancloud demo
+cleancloud demo --category ai
 
-```bash
+# Prêt à scanner votre cloud ? Ajoutez votre fournisseur :
+pipx install 'cleancloud[aws]'           # ou [azure], [gcp], [all]
 cleancloud scan --provider aws --all-regions
 cleancloud scan --provider azure
 cleancloud scan --provider gcp --all-projects
-cleancloud scan --provider aws --category ai   # détectez les endpoints SageMaker inactifs
 ```
 
 ---
@@ -244,7 +242,7 @@ Entièrement en lecture seule. Sûr pour la production et les environnements ré
 ## Démarrage
 
 ```bash
-pipx install cleancloud
+pipx install 'cleancloud[all]'                     # tous les SDK cloud (AWS + Azure + GCP)
 cleancloud demo                                    # aucun credential requis
 ```
 

README.md

@@ -22,18 +22,16 @@ CleanCloud tells you exactly what to delete in your cloud — with cost per reso
 ## Quick Start
 
 ```bash
+# Try it — no credentials needed:
 pipx install cleancloud
-cleancloud demo                      # see sample findings — no credentials needed
-cleancloud demo --category ai        # see AI/ML waste findings (SageMaker, AML, Vertex AI)
-```
-
-Scan your cloud:
+cleancloud demo
+cleancloud demo --category ai
 
-```bash
+# Ready to scan your cloud? Add your provider:
+pipx install 'cleancloud[aws]'          # or [azure], [gcp], [all]
 cleancloud scan --provider aws --all-regions
 cleancloud scan --provider azure
 cleancloud scan --provider gcp --all-projects
-cleancloud scan --provider aws --category ai   # detect idle SageMaker endpoints
 ```
 
 ---
@@ -244,7 +242,7 @@ Fully read-only. Safe for production and regulated environments.
 ## Get Started
 
 ```bash
-pipx install cleancloud
+pipx install 'cleancloud[all]'            # all cloud SDKs (AWS + Azure + GCP)
 cleancloud demo                           # no credentials needed
 ```
 

cleancloud/cli.py

@@ -42,7 +42,7 @@ def _version_info():
 
     if not providers:
         lines.append("")
-        lines.append("Install providers: pipx install cleancloud --force")
+        lines.append("Install providers: pip install 'cleancloud[aws]'  # or [azure], [gcp], [all]")
 
     return "\n".join(lines)
 

cleancloud/doctor/runner.py

@@ -1,10 +1,42 @@
 import sys
 from typing import Optional
 
-from cleancloud.doctor.aws import run_aws_ai_doctor, run_aws_doctor
-from cleancloud.doctor.azure import run_azure_ai_doctor, run_azure_doctor
 from cleancloud.doctor.common import DoctorError, info, success
-from cleancloud.doctor.gcp import run_gcp_ai_doctor, run_gcp_doctor
+
+try:
+    from cleancloud.doctor.aws import run_aws_ai_doctor, run_aws_doctor
+
+    _AWS_DOCTOR_AVAILABLE = True
+except ImportError:
+    _AWS_DOCTOR_AVAILABLE = False
+    run_aws_doctor = run_aws_ai_doctor = None  # type: ignore[assignment]
+
+try:
+    from cleancloud.doctor.azure import run_azure_ai_doctor, run_azure_doctor
+
+    _AZURE_DOCTOR_AVAILABLE = True
+except ImportError:
+    _AZURE_DOCTOR_AVAILABLE = False
+    run_azure_doctor = run_azure_ai_doctor = None  # type: ignore[assignment]
+
+try:
+    from cleancloud.doctor.gcp import run_gcp_ai_doctor, run_gcp_doctor
+
+    _GCP_DOCTOR_AVAILABLE = True
+except ImportError:
+    _GCP_DOCTOR_AVAILABLE = False
+    run_gcp_doctor = run_gcp_ai_doctor = None  # type: ignore[assignment]
+
+_DOCTOR_AVAILABLE = {
+    "aws": lambda: _AWS_DOCTOR_AVAILABLE,
+    "azure": lambda: _AZURE_DOCTOR_AVAILABLE,
+    "gcp": lambda: _GCP_DOCTOR_AVAILABLE,
+}
+_INSTALL_HINTS = {
+    "aws": "pip install 'cleancloud[aws]'",
+    "azure": "pip install 'cleancloud[azure]'",
+    "gcp": "pip install 'cleancloud[gcp]'",
+}
 
 
 def run_doctor(
@@ -46,6 +78,14 @@ def run_doctor(
 
     # Run checks for each provider
     for p in providers_to_check:
+        if not _DOCTOR_AVAILABLE.get(p, lambda: True)():
+            hint = _INSTALL_HINTS.get(p, "pip install 'cleancloud[all]'")
+            info(f"Provider '{p}' SDK is not installed. Install it with: {hint}")
+            results[p] = {"status": "failed", "error": f"SDK not installed — {hint}"}
+            if len(providers_to_check) == 1:
+                sys.exit(1)
+            continue
+
         try:
             if p == "aws":
                 if category == "ai":