Implement immediate feedback for unsupported test environments for models deployment

[Copilot]

This PR adds comprehensive environment validation to provide immediate feedback when users attempt to run model tests on unsupported configurations, helping them understand limitations and avoid confusion when tests fail.

Problem

Users running model tests on unsupported environments (e.g., macOS without NVIDIA support, incompatible Python versions) would encounter confusing failures without clear guidance on what was wrong or how to fix it.

Solution

Added early environment validation that checks for:

1. Python Version Compatibility

   • Hard fails for Python < 3.8 with clear error message
   • Shows warnings for Python < 3.9 for optimal compatibility

2. Platform-Specific GPU Support

   • Detects macOS without NVIDIA GPU support for GPU-requiring models
   • Analyzes model configuration to determine GPU requirements
   • Provides different behavior for GPU vs CPU-only models

3. Docker Availability

   • Warns when Docker is not available for container-based testing

Key Features

• Early Validation: Runs before any heavy model operations to fail fast
• Smart Detection: Analyzes model configuration to determine actual requirements
• Clear Messaging: Provides actionable error messages with specific recommendations
• Graceful Degradation: Warnings for non-critical issues, errors for blocking issues

Example Output

For a GPU model on macOS without NVIDIA support:

[INFO] Validating test environment...
[ERROR] ❌ Environment validation failed:
[ERROR]   1. macOS does not support NVIDIA GPU acceleration for model testing. Your model configuration requires GPU support. Please test on a Linux system with NVIDIA GPU support, or modify your model configuration to use CPU-only inference.
[ERROR] 
💡 To resolve these issues:
   • Update your Python version if needed
   • Use a Linux system with NVIDIA drivers for GPU models
   • Modify your model configuration for CPU-only inference
   • Check the Clarifai documentation for supported environments

Changes Made

• Modified: clarifai/runners/models/model_run_locally.py

  • Added _validate_test_environment() method with comprehensive checks
  • Integrated validation call early in main() function

• Added: tests/runners/test_environment_validation.py

  • Complete test suite with 7 test cases covering different scenarios
  • Tests for Python version validation, platform detection, GPU requirements
  • Integration tests ensuring validation is called in main flow

Testing

All tests pass, including:

• ✅ Python version validation (current version passes, old versions fail)
• ✅ macOS GPU model detection (fails appropriately)
• ✅ macOS CPU model detection (passes with warnings)
• ✅ Linux validation (passes)
• ✅ Integration with main function
• ✅ Early exit behavior on validation failure

Fixes #657.

[!WARNING]

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• huggingface.co
  • Triggering command: python -m pytest tests/REDACTEDs/test_model_run_locally.py::test_create_model_instance -v (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to my firewall allow list

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.