ROCm First-Aid Agent

ROCm First-Aid Agent is a beginner-friendly agentic debugging tool for developers working with AMD/ROCm, PyTorch, Hugging Face models, and Hugging Face Spaces deployments. Many AI developers get blocked by confusing GPU setup errors, model loading failures, missing dependencies, or ROCm/PyTorch compatibility issues. This app turns pasted error logs and optional environment details into a structured first-aid report. The workflow is split into specialized agents: a Triage Agent identifies the likely failure category, an Environment Doctor Agent checks missing ROCm/GPU/Python/PyTorch context, a Fix Planner Agent creates a safe repair plan, a Verification Agent suggests smoke tests, and an AMD Feedback Agent summarizes ROCm-specific learnings for reproducible issue reports. The project is built with Python, Gradio Blocks, Hugging Face InferenceClient, and Qwen. It is designed for Hugging Face Spaces and AMD Developer Cloud / ROCm workflows. It does not directly modify a user’s machine; instead, it provides practical, beginner-safe debugging guidance and separates safe checks from risky system changes.