| # CLAUDE.md | |
| This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. | |
| ## Project Overview | |
| This is a **Test Results Dashboard** project (Tcid) that provides interactive visualization of AI model testing results. The project consists of two main applications: | |
| 1. **Gradio Dashboard** (`app.py`) - Python-based web dashboard using Gradio and Matplotlib | |
| 2. **HTML Dashboard** (`index.html`) - Standalone HTML dashboard with Chart.js visualization | |
| Both dashboards display test results for AI models including metrics like passed, failed, skipped, and error counts. | |
| ## Architecture | |
| ### Core Components | |
| - **app.py**: Main Gradio application with dark theme UI, sidebar navigation, and matplotlib pie charts | |
| - **model_stats.json**: JSON data file containing test results for different AI models | |
| - **index.html**: Self-contained HTML dashboard with device-specific performance comparison (NVIDIA vs AMD) | |
| - **requirements.txt**: Python dependencies (currently only matplotlib>=3.8) | |
| ### Data Structure | |
| Model statistics follow this format: | |
| ```json | |
| { | |
| "model_name": { | |
| "passed": int, | |
| "failed": int, | |
| "skipped": int, | |
| "error": int | |
| } | |
| } | |
| ``` | |
| The HTML dashboard extends this with device-specific data for NVIDIA and AMD performance comparisons. | |
| ## Development Commands | |
| ### Environment Setup | |
| ```bash | |
| # Activate virtual environment | |
| source venv_tci/bin/activate | |
| # Install dependencies | |
| pip install -r requirements.txt | |
| ``` | |
| ### Running the Applications | |
| **Gradio Dashboard:** | |
| ```bash | |
| python app.py | |
| ``` | |
| **HTML Dashboard:** | |
| Open `index.html` directly in a web browser - no server required. | |
| ### Python Environment | |
| - Python 3.12.4 | |
| - Virtual environment located at `venv_tci/` | |
| - Dependencies managed via `requirements.txt` | |
| ## Key Implementation Details | |
| ### Gradio Application (app.py) | |
| - Uses `MODELS` dictionary for hardcoded test data (lines 8-12) | |
| - `plot_model_stats()` function generates matplotlib pie charts with dark theme | |
| - Custom CSS for dark theme styling (lines 77-133) | |
| - Sidebar navigation with model selection buttons | |
| - Real-time chart updates on model selection | |
| ### Data Management | |
| - Model data is currently hardcoded in `app.py` | |
| - External JSON data file `model_stats.json` exists but is not integrated | |
| - HTML dashboard has embedded JavaScript data | |
| ### Styling | |
| - Dark theme with black backgrounds (#000000) | |
| - Custom color scheme: Green (passed), Red (failed), Orange (skipped), Purple (error) | |
| - Responsive design with sidebar layout | |
| ## Hugging Face Spaces Configuration | |
| This project is configured as a Hugging Face Space: | |
| - SDK: Gradio 5.38.0 | |
| - App file: app.py | |
| - Space emoji: 👁 | |
| - Color theme: indigo to pink gradient |