HF_UPDATE_GUIDE.md

Hugging Face Space Update Guide

Since you already have the structure at riazmo/ui-regression-testing, you should replace the existing files. This is better than creating a new Space because it maintains your existing URL and history.

🛠 Update Steps

1. Backup (Optional but Recommended)

Before replacing files, you can create a new branch in your HF Space repository if you want to keep the old version:

git checkout -b v1-original
git push origin v1-original
git checkout main

2. Replace Core Files

Upload and overwrite the following files from the provided ui-regression-testing-langgraph-enhanced.zip:

File Path	Description of Change
app.py	Updated to support the new two-step LangGraph workflow (Capture -> Review -> Analyze).
workflow.py	Completely refactored to include persistence, subgraphs, and breakpoints.
state_schema.py	Updated with dictionary-based state and LangGraph reducers.
agents/	All files in this folder have been updated to handle the new state structure.
requirements.txt	Ensure langgraph, langchain, and langchain-core are included.

3. Add New Files

Add these new files to your repository to enable the new features:

• README_LANGGRAPH.md: Documentation for the new features.
• storage_manager.py: Handles persistent screenshot storage.
• hf_vision_analyzer.py: Integrated module for Hugging Face vision models.

4. Configuration

Ensure your Hugging Face Space has the following Secrets configured in the Settings tab:

• FIGMA_ACCESS_TOKEN: Your Figma API key.
• HUGGINGFACE_API_KEY: Your HF token (required for the vision model analysis).

🚀 What Happens Next?

Once you push these changes, Hugging Face will automatically rebuild your Space. The new UI will allow you to:

1. Start Capture: The agents will fetch Figma designs and website screenshots.
2. Review: The workflow will pause (using LangGraph Breakpoints), allowing you to see the screenshots in the Gradio gallery.
3. Approve & Analyze: Click the resume button to trigger the AI analysis and generate the final report.