| import gradio as gr |
| import torch |
| import os |
| import sys |
| from PIL import Image |
| import uuid |
| import huggingface_hub |
| sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))) |
|
|
| from hpsv3.inference import HPSv3RewardInferencer |
| try: |
| import ImageReward as RM |
| from hpsv2.src.open_clip import create_model_and_transforms, get_tokenizer |
| except: |
| RM = None |
| create_model_and_transforms = None |
| get_tokenizer = None |
| print("ImageReward or HPSv2 dependencies not found. Skipping those models.") |
|
|
| from transformers import AutoProcessor, AutoModel |
|
|
| |
| DEVICE = 'cuda' if torch.cuda.is_available() else 'cpu' |
| DTYPE = torch.bfloat16 if DEVICE == 'cuda' else torch.float32 |
|
|
| |
| MODEL_CONFIGS = { |
| "HPSv3_7B": { |
| "name": "HPSv3 7B", |
| "type": "hpsv3" |
| }, |
| "HPSv2": { |
| "name": "HPSv2", |
| "checkpoint_path": "xswu/HPSv2/HPS_v2.1_compressed.pt", |
| "type": "hpsv2" |
| }, |
| "ImageReward": { |
| "name": "ImageReward v1.0", |
| "checkpoint_path": "ImageReward-v1.0", |
| "type": "imagereward" |
| }, |
| "PickScore": { |
| "name": "PickScore", |
| "checkpoint_path": "yuvalkirstain/PickScore_v1", |
| "type": "pickscore" |
| }, |
| "CLIP": { |
| "name": "CLIP ViT-H-14", |
| "checkpoint_path": "laion/CLIP-ViT-H-14-laion2B-s32B-b79K", |
| "type": "clip" |
| } |
| } |
|
|
| |
| current_models = {} |
| current_model_name = None |
|
|
| |
| def load_model(model_key, update_status_fn=None): |
| """Load the specified model based on the model key.""" |
| global current_models, current_model_name |
| |
| if model_key == current_model_name and model_key in current_models: |
| return current_models[model_key] |
| |
| if update_status_fn: |
| update_status_fn(f"🔄 Loading {MODEL_CONFIGS[model_key]['name']}...") |
| |
| |
| current_models.clear() |
| torch.cuda.empty_cache() |
| |
| config = MODEL_CONFIGS[model_key] |
| |
| try: |
| if config["type"] == "hpsv3": |
| checkpoint_path = huggingface_hub.hf_hub_download("MizzenAI/HPSv3", 'HPSv3.safetensors', repo_type='model') |
| model = HPSv3RewardInferencer( |
| device=DEVICE, |
| checkpoint_path=checkpoint_path |
| ) |
| elif config["type"] == "hpsv2": |
| model_obj, preprocess_train, preprocess_val = create_model_and_transforms( |
| 'ViT-H-14', |
| 'laion2B-s32B-b79K', |
| precision='amp', |
| device=DEVICE, |
| jit=False, |
| force_quick_gelu=False, |
| force_custom_text=False, |
| force_patch_dropout=False, |
| force_image_size=None, |
| pretrained_image=False, |
| image_mean=None, |
| image_std=None, |
| light_augmentation=True, |
| aug_cfg={}, |
| output_dict=True, |
| with_score_predictor=False, |
| with_region_predictor=False |
| ) |
| checkpoint_path = huggingface_hub.hf_hub_download("xswu/HPSv2", 'HPS_v2.1_compressed.pt', repo_type='model') |
| checkpoint = torch.load(checkpoint_path, map_location=DEVICE, weights_only=False) |
| model_obj.load_state_dict(checkpoint['state_dict']) |
| model_obj = model_obj.to(DEVICE).eval() |
| tokenizer = get_tokenizer('ViT-H-14') |
| model = {"model": model_obj, "preprocess_val": preprocess_val, "tokenizer": tokenizer} |
| elif config["type"] == "imagereward": |
| model = RM.load(config["checkpoint_path"]) |
| elif config["type"] == "pickscore": |
| processor = AutoProcessor.from_pretrained('/preflab/models/CLIP-ViT-H-14-laion2B-s32B-b79K') |
| model_obj = AutoModel.from_pretrained(config["checkpoint_path"]).eval().to(DEVICE) |
| model = {"model": model_obj, "processor": processor} |
| elif config["type"] == "clip": |
| model_obj = AutoModel.from_pretrained(config["checkpoint_path"]).to(DEVICE) |
| processor = AutoProcessor.from_pretrained(config["checkpoint_path"]) |
| model = {"model": model_obj, "processor": processor} |
| else: |
| raise ValueError(f"Unknown model type: {config['type']}") |
| |
| current_models[model_key] = model |
| current_model_name = model_key |
| |
| if update_status_fn: |
| update_status_fn(f"✅ {MODEL_CONFIGS[model_key]['name']} loaded successfully!") |
| |
| return model |
| except Exception as e: |
| error_msg = f"Error loading model {model_key}: {e}" |
| print(error_msg) |
| if update_status_fn: |
| update_status_fn(f"❌ {error_msg}") |
| return None |
|
|
| def score_with_model(model_key, image_paths, prompts): |
| """Score images using the specified model.""" |
| model = load_model(model_key) |
| if model is None: |
| raise ValueError(f"Failed to load model {model_key}") |
| |
| config = MODEL_CONFIGS[model_key] |
| |
| if config["type"] == "hpsv3": |
| rewards = model.reward(image_paths, prompts) |
| return [reward[0].item() for reward in rewards] |
| elif config["type"] == "hpsv2": |
| return score_hpsv2_batch(model, image_paths, prompts) |
| elif config["type"] == "imagereward": |
| return [model.score(prompt, image_path) for prompt, image_path in zip(prompts, image_paths)] |
| elif config["type"] == "pickscore": |
| return score_pickscore_batch(prompts, image_paths, model["model"], model["processor"]) |
| elif config["type"] == "clip": |
| return score_clip_batch(model["model"], model["processor"], image_paths, prompts) |
| else: |
| raise ValueError(f"Unknown model type: {config['type']}") |
|
|
| def score_hpsv2_batch(model_dict, image_paths, prompts): |
| """Score using HPSv2 model.""" |
| model = model_dict['model'] |
| preprocess_val = model_dict['preprocess_val'] |
| tokenizer = model_dict['tokenizer'] |
|
|
| |
| images = [preprocess_val(Image.open(p)).unsqueeze(0)[:,:3,:,:] for p in image_paths] |
| images = torch.cat(images, dim=0).to(device=DEVICE) |
| texts = tokenizer(prompts).to(device=DEVICE) |
| with torch.no_grad(): |
| outputs = model(images, texts) |
| image_features, text_features = outputs["image_features"], outputs["text_features"] |
| logits_per_image = image_features @ text_features.T |
| hps_scores = torch.diagonal(logits_per_image).cpu() |
| return [score.item() for score in hps_scores] |
|
|
| def score_pickscore_batch(prompts, image_paths, model, processor): |
| """Score using PickScore model.""" |
| pil_images = [Image.open(p) for p in image_paths] |
| image_inputs = processor( |
| images=pil_images, |
| padding=True, |
| truncation=True, |
| max_length=77, |
| return_tensors="pt", |
| ).to(DEVICE) |
| |
| text_inputs = processor( |
| text=prompts, |
| padding=True, |
| truncation=True, |
| max_length=77, |
| return_tensors="pt", |
| ).to(DEVICE) |
|
|
| with torch.no_grad(): |
| image_embs = model.get_image_features(**image_inputs) |
| image_embs = image_embs / torch.norm(image_embs, dim=-1, keepdim=True) |
| text_embs = model.get_text_features(**text_inputs) |
| text_embs = text_embs / torch.norm(text_embs, dim=-1, keepdim=True) |
| scores = model.logit_scale.exp() * (text_embs @ image_embs.T) |
| return [scores[i, i].cpu().item() for i in range(len(prompts))] |
|
|
| def score_clip_batch(model, processor, image_paths, prompts): |
| """Score using CLIP model.""" |
| pil_images = [Image.open(p) for p in image_paths] |
| image_inputs = processor( |
| images=pil_images, |
| padding=True, |
| truncation=True, |
| max_length=77, |
| return_tensors="pt", |
| ).to(DEVICE) |
| |
| text_inputs = processor( |
| text=prompts, |
| padding=True, |
| truncation=True, |
| max_length=77, |
| return_tensors="pt", |
| ).to(DEVICE) |
|
|
| with torch.no_grad(): |
| image_embs = model.get_image_features(**image_inputs) |
| image_embs = image_embs / torch.norm(image_embs, dim=-1, keepdim=True) |
| text_embs = model.get_text_features(**text_inputs) |
| text_embs = text_embs / torch.norm(text_embs, dim=-1, keepdim=True) |
| scores = image_embs @ text_embs.T |
| return [scores[i, i].cpu().item() for i in range(len(prompts))] |
|
|
| |
| print("Loading default HPSv3 model...") |
| load_model("HPSv3_7B") |
| print("Model loaded successfully.") |
|
|
| |
| def get_score_interpretation(score): |
| """Returns a color-coded qualitative interpretation of the score.""" |
| if score is None: |
| return "" |
| |
| if score < 0: |
| color = "#ef4444" |
| bg_color = "rgba(239, 68, 68, 0.1)" |
| icon = "❌" |
| feedback = "Poor Quality" |
| comment = "The image has significant quality issues or doesn't match the prompt well." |
| elif score < 5: |
| color = "#f59e0b" |
| bg_color = "rgba(245, 158, 11, 0.1)" |
| icon = "⚠️" |
| feedback = "Needs Improvement" |
| comment = "The image is acceptable but could be enhanced in quality or prompt alignment." |
| elif score < 10: |
| color = "#10b981" |
| bg_color = "rgba(16, 185, 129, 0.1)" |
| icon = "✅" |
| feedback = "Good Quality" |
| comment = "A well-crafted image that aligns nicely with the given prompt." |
| else: |
| color = "#06d6a0" |
| bg_color = "rgba(6, 214, 160, 0.1)" |
| icon = "⭐" |
| feedback = "Excellent!" |
| comment = "Outstanding quality and perfect alignment with the prompt." |
| |
| return f""" |
| <div style=' |
| background: {bg_color}; |
| border: 2px solid {color}; |
| border-radius: 16px; |
| padding: 20px; |
| text-align: center; |
| margin: 10px 0; |
| '> |
| <div style='font-size: 2rem; margin-bottom: 8px;'>{icon}</div> |
| <h3 style='color: {color}; font-size: 1.4rem; font-weight: 700; margin: 8px 0;'>{feedback}</h3> |
| <p style='color: #666; font-size: 0.95rem; margin: 0; line-height: 1.4;'>{comment}</p> |
| </div> |
| """ |
|
|
| |
| def handle_model_change(model_key): |
| """Handle model selection change.""" |
| global current_model_name |
| |
| if model_key != current_model_name: |
| |
| yield f"🔄 Loading {MODEL_CONFIGS[model_key]['name']}..." |
| |
| |
| model = load_model(model_key) |
| |
| if model is not None: |
| yield f"✅ Current model: {MODEL_CONFIGS[model_key]['name']}" |
| else: |
| yield f"❌ Failed to load {MODEL_CONFIGS[model_key]['name']}" |
| else: |
| yield f"✅ Current model: {MODEL_CONFIGS[model_key]['name']}" |
|
|
| |
| def predict_score(image, prompt, model_name): |
| """Takes Gradio inputs and returns the score, interpretation, and status.""" |
| if image is None: |
| return None, "", "❌ Error: Please upload an image." |
| if not prompt or not prompt.strip(): |
| return None, "", "❌ Error: Please enter a prompt." |
|
|
| temp_dir = "temp_images_for_gradio" |
| os.makedirs(temp_dir, exist_ok=True) |
| temp_path = os.path.join(temp_dir, f"{uuid.uuid4()}.png") |
| |
| try: |
| Image.fromarray(image).save(temp_path) |
| scores = score_with_model(model_name, [temp_path], [prompt]) |
| score = round(scores[0], 4) |
| interpretation = get_score_interpretation(score) |
| return score, interpretation, "✅ Analysis completed successfully!" |
| except Exception as e: |
| print(f"An error occurred during inference: {e}") |
| return None, "", f"❌ Processing error: {e}" |
| finally: |
| if os.path.exists(temp_path): |
| os.remove(temp_path) |
|
|
| |
| def compare_images(image1, image2, prompt, model_name): |
| """Compare two images and determine which one is better based on the prompt.""" |
| if image1 is None or image2 is None: |
| return None, None, "", "❌ Error: Please upload both images." |
| if not prompt or not prompt.strip(): |
| return None, None, "", "❌ Error: Please enter a prompt." |
|
|
| temp_dir = "temp_images_for_gradio" |
| os.makedirs(temp_dir, exist_ok=True) |
| temp_path1 = os.path.join(temp_dir, f"{uuid.uuid4()}_img1.png") |
| temp_path2 = os.path.join(temp_dir, f"{uuid.uuid4()}_img2.png") |
| |
| try: |
| Image.fromarray(image1).save(temp_path1) |
| Image.fromarray(image2).save(temp_path2) |
| |
| |
| scores = score_with_model(model_name, [temp_path1, temp_path2], [prompt, prompt]) |
| score1 = round(scores[0], 4) |
| score2 = round(scores[1], 4) |
| |
| |
| if score1 > score2: |
| winner_text = f"🏆 **Image 1 is better!**\n\nImage 1 Score: **{score1}**\nImage 2 Score: **{score2}**\n\nDifference: **+{round(score1-score2, 4)}**" |
| elif score2 > score1: |
| winner_text = f"🏆 **Image 2 is better!**\n\nImage 1 Score: **{score1}**\nImage 2 Score: **{score2}**\n\nDifference: **+{round(score2-score1, 4)}**" |
| else: |
| winner_text = f"🤝 **It's a tie!**\n\nBoth images scored: **{score1}**" |
| |
| return score1, score2, winner_text, "✅ Comparison completed successfully!" |
| |
| except Exception as e: |
| print(f"An error occurred during comparison: {e}") |
| return None, None, "", f"❌ Processing error: {e}" |
| finally: |
| if os.path.exists(temp_path1): |
| os.remove(temp_path1) |
| if os.path.exists(temp_path2): |
| os.remove(temp_path2) |
|
|
| |
| with gr.Blocks(theme=gr.themes.Soft(), title="HPSv3 - Human Preference Score v3") as demo: |
| gr.HTML(f""" |
| <div style="text-align: center; margin-bottom: 20px;"> |
| <h1>🎨 HPSv3: Human Preference Score v3</h1> |
| <p>Evaluate image quality and alignment with prompts with multiple models.</p> |
| <p><a href="https://mizzenai.github.io/HPSv3.project/" target="_blank">🌐 Project Website</a> | |
| <a href="https://huggingface.co/papers/2508.03789" target="_blank">📄 Paper</a> | |
| <a href="https://github.com/MizzenAI/HPSv3" target="_blank">💻 Code</a></p> |
| </div> |
| """) |
| |
| |
| with gr.Row(): |
| model_selector = gr.Dropdown( |
| choices=[(config["name"], key) for key, config in MODEL_CONFIGS.items()], |
| value="HPSv3_7B", |
| label="🤖 Select Model", |
| ) |
| model_status = gr.Textbox( |
| label="Model Status", |
| value=f"✅ Current model: {MODEL_CONFIGS['HPSv3_7B']['name']}", |
| interactive=False, |
| scale=2 |
| ) |
| |
| with gr.Tabs(): |
| |
| with gr.TabItem("📊 Image Scoring"): |
| with gr.Row(equal_height=False): |
| with gr.Column(scale=2): |
| with gr.Group(): |
| gr.Markdown("### 🖼️ **Upload & Describe**") |
| image_input = gr.Image( |
| type="numpy", |
| label="Upload Image", |
| height=450 |
| ) |
| prompt_input = gr.Textbox( |
| label="Prompt Description", |
| placeholder="Describe what the image should represent...", |
| lines=3, |
| max_lines=5 |
| ) |
| |
| with gr.Column(scale=1): |
| with gr.Group(): |
| gr.Markdown("### 🎯 **Quality Assessment**") |
| score_output = gr.Number( |
| label="Score", |
| elem_id="score-output", |
| precision=4 |
| ) |
| interpretation_output = gr.Markdown(label="") |
| status_output = gr.Textbox( |
| label="Status", |
| interactive=False |
| ) |
| submit_button = gr.Button( |
| "🚀 Run Evaluation", |
| variant="primary", |
| size="lg" |
| ) |
| |
| submit_button.click( |
| fn=predict_score, |
| inputs=[image_input, prompt_input, model_selector], |
| outputs=[score_output, interpretation_output, status_output] |
| ) |
|
|
| with gr.Group(): |
| gr.Examples( |
| examples=[ |
| ["assets/example1.png", "cute chibi anime cartoon fox, smiling wagging tail with a small cartoon heart above sticker, high resolution, vibrant colors"], |
| ["assets/example2.png", "cute chibi anime cartoon fox, smiling wagging tail with a small cartoon heart above sticker, high resolution, vibrant colors"], |
| ], |
| inputs=[image_input, prompt_input], |
| outputs=[score_output, interpretation_output, status_output], |
| fn=lambda img, prompt: predict_score(img, prompt, "HPSv3_7B"), |
| cache_examples=False |
| ) |
| |
| |
| with gr.TabItem("⚖️ Image Comparison"): |
| with gr.Row(equal_height=False): |
| with gr.Column(scale=2): |
| with gr.Group(): |
| gr.Markdown("### 🖼️ **Upload Images & Prompt**") |
| with gr.Row(): |
| image1_input = gr.Image( |
| type="numpy", |
| label="Image 1", |
| height=300 |
| ) |
| image2_input = gr.Image( |
| type="numpy", |
| label="Image 2", |
| height=300 |
| ) |
| prompt_compare_input = gr.Textbox( |
| label="Prompt Description", |
| placeholder="Describe what the images should represent...", |
| lines=3, |
| max_lines=5 |
| ) |
| |
| with gr.Column(scale=1): |
| with gr.Group(): |
| gr.Markdown("### 🎯 **Comparison Results**") |
| score1_output = gr.Number( |
| label="Image 1 Score", |
| precision=4 |
| ) |
| score2_output = gr.Number( |
| label="Image 2 Score", |
| precision=4 |
| ) |
| comparison_result = gr.Markdown(label="Winner") |
| status_compare_output = gr.Textbox( |
| label="Status", |
| interactive=False |
| ) |
| |
| compare_button = gr.Button( |
| "⚖️ Compare Images", |
| variant="primary", |
| size="lg" |
| ) |
| |
| compare_button.click( |
| fn=compare_images, |
| inputs=[image1_input, image2_input, prompt_compare_input, model_selector], |
| outputs=[score1_output, score2_output, comparison_result, status_compare_output] |
| ) |
|
|
| with gr.Group(): |
| gr.Examples( |
| examples=[ |
| ["assets/example1.png", "assets/example2.png", "cute chibi anime cartoon fox, smiling wagging tail with a small cartoon heart above sticker, high resolution, vibrant colors"], |
| ["assets/example2.png", "assets/example1.png", "cute chibi anime cartoon fox, smiling wagging tail with a small cartoon heart above sticker, high resolution, vibrant colors"], |
| ], |
| inputs=[image1_input, image2_input, prompt_compare_input], |
| outputs=[score1_output, score2_output, comparison_result, status_compare_output], |
| fn=lambda img1, img2, prompt: compare_images(img1, img2, prompt, "HPSv3_7B"), |
| cache_examples=False |
| ) |
|
|
| |
| model_selector.change( |
| fn=handle_model_change, |
| inputs=[model_selector], |
| outputs=[model_status] |
| ) |
|
|
| def main(): |
| """Main function to launch the demo.""" |
| demo.launch( |
| server_name="0.0.0.0", |
| server_port=7860, |
| share=False, |
| favicon_path=None, |
| show_error=True, |
| ) |
|
|
| if __name__ == "__main__": |
| main() |
|
|