docs: fix sample download paths; chore: Spaces-friendly Gradio launch (PORT, 0.0.0.0)

CHEATSHEET.md

@@ -7,7 +7,7 @@
 python app.py
 
 # Download sample images
-python download_samples.py
+python examples/download_samples.py
 
 # Run tests
 pytest tests/ -v

CODE_QUALITY.md

@@ -205,7 +205,7 @@ License: MIT
 - **Comments**: Present in HTML sections
 - **Length**: 800+ lines
 
-#### 7. `download_samples.py` ✅
+#### 7. `examples/download_samples.py` ✅
 - **Docstring**: Added at module level
 - **Formatting**: Black + isort applied
 - **Comments**: Added for clarity
@@ -397,7 +397,7 @@ def predict_image(image, model, processor, top_k=5):
 
 ### Black (Code Formatter)
 ```bash
-black src/ app.py download_samples.py --line-length 100
+black src/ app.py examples/download_samples.py --line-length 100
 ```
 
 **Configuration**:
@@ -407,7 +407,7 @@ black src/ app.py download_samples.py --line-length 100
 
 ### isort (Import Sorter)
 ```bash
-isort src/ app.py download_samples.py --profile black
+isort src/ app.py examples/download_samples.py --profile black
 ```
 
 **Configuration**:

PROJECT_SUMMARY.md

@@ -91,8 +91,8 @@ Each directory includes a README.md with:
 - Tips for best results
 
 ### 🔧 Download Scripts
-1. **download_samples.py** (6KB) - Python script to download images
-2. **download_samples.sh** (5.2KB) - Bash script alternative
+1. **examples/download_samples.py** (6KB) - Python script to download images
+2. **examples/download_samples.sh** (5.2KB) - Bash script alternative
 
 ---
 

README.md

@@ -104,7 +104,7 @@ examples/
 └── general/                 # 4 images - Miscellaneous testing
 ```
 
-**Quick Download**: Run `python download_samples.py` to get all test images instantly!
+**Quick Download**: Run `python examples/download_samples.py` to get all test images instantly!
 
 See [examples/README.md](examples/README.md) for detailed image descriptions and testing guidelines.
 
@@ -240,11 +240,11 @@ pip install -r requirements.txt
 
 ```bash
 # Download 20 curated test images for all tabs
-python download_samples.py
+python examples/download_samples.py
 
 # Or use the bash script
-chmod +x download_samples.sh
-./download_samples.sh
+chmod +x examples/download_samples.sh
+./examples/download_samples.sh
 ```
 
 This creates an `examples/` directory with images organized by tab.
@@ -277,7 +277,7 @@ ViT-XAI-Dashboard/
 ├── app.py                      # Main Gradio application
 ├── requirements.txt            # Python dependencies
 ├── README.md                   # This file
-├── download_samples.py         # Script to download test images
+├── examples/download_samples.py         # Script to download test images
 │
 ├── src/
 │   ├── __init__.py

app.py

@@ -830,4 +830,8 @@ with gr.Blocks(theme=gr.themes.Soft(), css=custom_css, title="ViT Auditing Toolk
 
 # Launch the application
 if __name__ == "__main__":
-    demo.launch(server_name="localhost", server_port=7860, share=False, show_error=True)
+    import os as _os
+    # Use dynamic host/port for portability (e.g., Hugging Face Spaces)
+    host = "0.0.0.0"
+    port = int(_os.environ.get("PORT", "7860"))
+    demo.launch(server_name=host, server_port=port, share=False, show_error=True)