Fix CloudProviderManager import issue by resolving module/package naming conflict

- Renamed cloud_providers.py to cloud_provider_manager.py to avoid conflict with cloud_providers/ package
- Updated import in executor.py to use the renamed module
- Fixed all 3 failing tests related to cloud provider auto-configuration
- All 292 tests now pass with 100% success rate
- No linting issues

The issue was that Python's import system was importing the cloud_providers package
(directory) instead of the cloud_providers.py module when both had the same name.
The package takes precedence in Python's import resolution.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: jeremymanning

clustrix.egg-info/PKG-INFO

@@ -99,11 +99,14 @@ Clustrix is a Python package that enables seamless distributed computing on clus
 
 - **Simple Decorator Interface**: Just add `@cluster` to any function
 - **Interactive Jupyter Widget**: `%%clusterfy` magic command with GUI configuration manager
-- **Multiple Cluster Support**: SLURM, PBS, SGE, Kubernetes, and SSH
+- **Multiple Cluster Support**: SLURM, PBS, SGE, Kubernetes, SSH, and major cloud providers
+- **Cloud Provider Integration**: Native support for AWS (EC2/EKS), Google Cloud (GCE/GKE), Azure (VM/AKS), Lambda Cloud, and HuggingFace Spaces
 - **Automatic Dependency Management**: Captures and replicates your exact Python environment
 - **Native Cost Monitoring**: Built-in cost tracking for all major cloud providers
+- **Kubernetes Support**: Deploy to EKS, GKE, AKS, or any Kubernetes cluster
 - **Loop Parallelization**: Automatically distributes loops across cluster nodes
 - **Flexible Configuration**: Easy setup with config files, environment variables, or interactive widget
+- **Dynamic Instance Selection**: Auto-populated dropdowns for cloud instance types and regions
 - **Error Handling**: Comprehensive error reporting and job monitoring
 
 ## Quick Start
@@ -167,13 +170,88 @@ import clustrix  # Auto-loads the magic command
 # - Save/load configurations to files
 ```
 
+#### Interactive Configuration Widget
+
+The Clustrix widget provides a comprehensive GUI for managing cluster configurations directly in Jupyter notebooks. Here's what you'll see when you use the `%%clusterfy` magic command:
+
+##### Default View
+When the widget first loads, it displays the "Local Single-core" configuration for quick testing:
+
+![Default widget view showing Local Single-core configuration](https://github.com/user-attachments/assets/44baefd7-9dd7-452d-bc43-ef53136d13a4)
+
+##### Configuration Dropdown
+The dropdown menu includes pre-built templates for various cluster types and cloud providers:
+
+![Configuration dropdown showing available templates](https://github.com/user-attachments/assets/744e2eef-e03e-46bd-9bb1-e0ed2c11cf45)
+
 The widget includes pre-built templates for:
-- **Local Development**: Run jobs on your local machine
-- **AWS GPU Instances**: p3.2xlarge, p3.8xlarge templates
-- **Google Cloud**: CPU and GPU instance configurations
-- **Azure**: Virtual machine templates with GPU support
-- **SLURM HPC**: University cluster configurations
-- **Kubernetes**: Container-based execution
+- **Local Development**: 
+  - Local Single-core: Run jobs on one CPU core
+  - Local Multi-core: Utilize all available CPU cores
+- **HPC Clusters**:
+  - SLURM: University and research cluster support
+  - PBS/SGE: Traditional HPC schedulers
+- **Cloud Providers**:
+  - **AWS**: EC2 instances and EKS Kubernetes clusters
+  - **Google Cloud**: Compute Engine VMs and GKE clusters
+  - **Azure**: Virtual Machines and AKS Kubernetes clusters
+  - **Lambda Cloud**: GPU-optimized instances for ML/AI
+  - **HuggingFace Spaces**: Deploy to HF Spaces infrastructure
+- **Kubernetes**: Native container orchestration support
+
+##### Cluster Configuration Examples
+
+###### SLURM Cluster Configuration
+For traditional HPC clusters, the widget provides all essential fields:
+
+![SLURM configuration with basic settings](https://github.com/user-attachments/assets/994a803d-485e-4d14-bf93-2f0223066510)
+
+The advanced settings accordion reveals additional options:
+
+![SLURM advanced configuration options](https://github.com/user-attachments/assets/0930eee0-ee52-4d53-9165-81e907c7d962)
+
+Advanced options include:
+- Module loads (e.g., `python/3.9`, `cuda/11.2`)
+- Environment variables
+- Pre-execution commands
+- Custom SSH key paths
+- Cost monitoring toggles
+
+###### Cloud Provider Configuration
+
+**Google Cloud Platform:**
+When selecting a cloud provider, only relevant fields are displayed:
+
+![GCP VM configuration interface](https://github.com/user-attachments/assets/53acb782-65cd-4b65-93a0-98286144f223)
+
+**Lambda Cloud GPU Instances:**
+The widget dynamically populates instance type dropdowns based on the selected provider:
+
+![Lambda Cloud with GPU instance dropdown](https://github.com/user-attachments/assets/4bd0e176-d5f3-430e-86af-ddbfff827d77)
+
+##### Key Widget Features
+
+1. **Dynamic Field Visibility**: Only shows fields relevant to the selected cluster type
+2. **Provider-Specific Options**: 
+   - AWS: Region selection, instance types, EKS cluster options
+   - Azure: Resource groups, VM sizes, AKS configuration
+   - GCP: Projects, zones, machine types, GKE options
+   - Lambda Cloud: GPU instance selection with live pricing
+3. **Input Validation**: Real-time validation for hostnames, IP addresses, and configuration values
+4. **Tooltips**: Hover over any field label to see detailed help text
+5. **Configuration Management**:
+   - Save configurations to YAML/JSON files
+   - Load existing configurations
+   - Test configurations before applying
+   - Add/delete custom configurations
+
+##### Using the Widget
+
+1. **Select a Configuration**: Choose from the dropdown or create a new one
+2. **Edit Settings**: Modify cluster connection details and resource requirements
+3. **Advanced Options**: Expand the accordion for environment setup and additional settings
+4. **Apply Configuration**: Click "Apply Configuration" to use these settings for subsequent `@cluster` decorated functions
+5. **Save for Later**: Use "Save Configuration" to persist settings to a file
 
 ### Configuration File
 
@@ -282,6 +360,116 @@ clustrix.configure(cluster_type='kubernetes')
 clustrix.configure(cluster_type='ssh', cluster_host='server.example.com')
 ```
 
+### Cloud Provider Integration
+
+Clustrix provides native integration with major cloud providers for both VM and Kubernetes deployments:
+
+#### AWS Integration
+
+```python
+# Configure AWS credentials and region
+clustrix.configure(
+    cluster_type='aws',
+    access_key_id='YOUR_ACCESS_KEY',
+    secret_access_key='YOUR_SECRET_KEY',
+    region='us-west-2'
+)
+
+# Run on EC2 instance
+@cluster(provider='aws', instance_type='p3.2xlarge', cores=8, memory='61GB')
+def train_on_aws():
+    # GPU-accelerated training on AWS
+    pass
+
+# Run on EKS Kubernetes cluster
+@cluster(provider='aws', cluster_type='kubernetes', cluster_name='my-eks-cluster')
+def distributed_training():
+    # Runs on Amazon EKS
+    pass
+```
+
+#### Google Cloud Integration
+
+```python
+# Configure GCP with service account
+clustrix.configure(
+    cluster_type='gcp',
+    project_id='your-project-id',
+    service_account_key='path/to/service-account-key.json',
+    region='us-central1'
+)
+
+# Run on Compute Engine
+@cluster(provider='gcp', machine_type='n1-highmem-8', cores=8, memory='52GB')
+def analyze_data():
+    # High-memory computation on GCP
+    pass
+
+# Run on GKE cluster
+@cluster(provider='gcp', cluster_type='kubernetes', cluster_name='my-gke-cluster')
+def kubernetes_job():
+    # Runs on Google Kubernetes Engine
+    pass
+```
+
+#### Azure Integration
+
+```python
+# Configure Azure with service principal
+clustrix.configure(
+    cluster_type='azure',
+    subscription_id='YOUR_SUBSCRIPTION_ID',
+    client_id='YOUR_CLIENT_ID',
+    client_secret='YOUR_CLIENT_SECRET',
+    tenant_id='YOUR_TENANT_ID',
+    region='eastus'
+)
+
+# Run on Azure VM
+@cluster(provider='azure', vm_size='Standard_NC6', cores=6, memory='56GB')
+def gpu_workload():
+    # GPU computation on Azure
+    pass
+
+# Run on AKS cluster
+@cluster(provider='azure', cluster_type='kubernetes', cluster_name='my-aks-cluster')
+def container_workload():
+    # Runs on Azure Kubernetes Service
+    pass
+```
+
+#### Lambda Cloud Integration
+
+```python
+# Configure Lambda Cloud for GPU workloads
+clustrix.configure(
+    cluster_type='lambda_cloud',
+    api_key='YOUR_LAMBDA_API_KEY'
+)
+
+# Run on Lambda GPU instance
+@cluster(provider='lambda_cloud', instance_type='gpu_1x_a100', cores=30, memory='200GB')
+def train_large_model():
+    # A100 GPU training on Lambda Cloud
+    pass
+```
+
+#### HuggingFace Spaces Integration
+
+```python
+# Configure HuggingFace Spaces
+clustrix.configure(
+    cluster_type='huggingface_spaces',
+    token='YOUR_HF_TOKEN'
+)
+
+# Deploy to HuggingFace Spaces
+@cluster(provider='huggingface_spaces', space_hardware='gpu-t4-medium')
+def inference_endpoint():
+    # Runs on HuggingFace infrastructure
+    pass
+```
+
 ## Command Line Interface
 
 ```bash

clustrix.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 README.md
 setup.py
 clustrix/__init__.py
+clustrix/async_executor_simple.py
 clustrix/cli.py
 clustrix/cloud_providers.py
 clustrix/config.py
@@ -20,13 +21,21 @@ clustrix.egg-info/entry_points.txt
 clustrix.egg-info/not-zip-safe
 clustrix.egg-info/requires.txt
 clustrix.egg-info/top_level.txt
+clustrix/cloud_providers/__init__.py
+clustrix/cloud_providers/aws.py
+clustrix/cloud_providers/azure.py
+clustrix/cloud_providers/base.py
+clustrix/cloud_providers/gcp.py
+clustrix/cloud_providers/huggingface_spaces.py
+clustrix/cloud_providers/lambda_cloud.py
 clustrix/cost_providers/__init__.py
 clustrix/cost_providers/aws.py
 clustrix/cost_providers/azure.py
 clustrix/cost_providers/gcp.py
 clustrix/cost_providers/lambda_cloud.py
 tests/__init__.py
 tests/conftest.py
+tests/test_async_execution.py
 tests/test_cli.py
 tests/test_cloud_providers.py
 tests/test_config.py

clustrix/cloud_providers.py renamed to clustrix/cloud_provider_manager.py

@@ -34,10 +34,4 @@
 except ImportError:
     pass
 
-# Import CloudProviderManager from the old cloud_providers module
-try:
-    from ..cloud_providers import CloudProviderManager  # noqa: F401
-except ImportError:
-    pass
-
-__all__ = ["PROVIDERS", "CloudProviderManager"]
+__all__ = ["PROVIDERS"]

clustrix/cloud_providers/__init__.py

@@ -66,9 +66,10 @@ def _setup_kubernetes(self):
                 and self.config.cluster_type == "kubernetes"
             ):
                 try:
-                    from . import cloud_providers as cloud_providers_module
+                    # Import CloudProviderManager from the renamed module
+                    from .cloud_provider_manager import CloudProviderManager
 
-                    cloud_manager = cloud_providers_module.CloudProviderManager(self.config)
+                    cloud_manager = CloudProviderManager(self.config)
                     result = cloud_manager.auto_configure()
 
                     if result.get("auto_configured"):

clustrix/executor.py

@@ -219,6 +219,7 @@ <h1>Source code for clustrix.config</h1><div class="highlight"><pre>
     <span class="n">cleanup_on_success</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span>
     <span class="n">prefer_local_parallel</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">local_parallel_threshold</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1000</span>  <span class="c1"># Use local if iterations &lt; threshold</span>
+    <span class="n">async_submit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>  <span class="c1"># Use asynchronous job submission</span>
 
     <span class="c1"># Advanced settings</span>
     <span class="n">environment_variables</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span>
@@ -395,7 +396,7 @@ <h1>Source code for clustrix.config</h1><div class="highlight"><pre>
                     &copy; Copyright 2025, Contextual Dynamics Laboratory
             </div>
             <div class="text-center text-white-50 font-italic mt-3">
-                <small>Last updated: Jun 27, 2025</small>
+                <small>Last updated: Jun 28, 2025</small>
                 <small>
                     Created using
                     <a class="text-white" href="https://github.com/wagtail/sphinx_wagtail_theme" rel="nofollow" target="_blank">