README.md

---
title: Viral Images
emoji: 🧠
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: "5.0.0"
app_file: app.py
pinned: false
---

# 🧠 Viral Images

**Upload an image, score it, and improve it.**

## What It Does
Viral Images analyzes your image across 8 dimensions:
- **Concept Match** — Does it convey your intended topic?
- **Visual Focus** — Is there a clear focal point that draws the eye?
- **Readability** — Is text legible and well-sized?
- **Complexity Balance** — Is detail level appropriate — not empty, not cluttered?
- **Communication Clarity** — Is the visual hierarchy clear and well-organized?
- **Predicted Neural Richness** — How visually engaging is the image?
- **Memorability** — Will viewers remember it after one viewing?
- **Improvement Potential** — How much room for improvement remains?

## How to Use
1. **Upload an image** (JPG, PNG, or any common format)
2. **Describe the concept** — what should this image communicate?
3. **Select audience and use case**
4. Click **"Score Image"**
5. Review scores, strengths, weaknesses, and suggestions

## Compare Mode
Upload an **original** and a **revised** version to see what improved and what to focus on next.

## ⚠️ Important Disclaimer
- Scores are **AI-predicted proxies**, not measurements of real brain activity.
- Scores do **not guarantee engagement, virality, or aesthetic quality**.
- Use as **directional feedback** to complement your own judgment.
- Predicted Neural Richness is estimated via computational proxy models, not from actual fMRI data.

## Technical Details
Models used: CLIP ViT-B/32 (concept matching), heuristic analysis (OpenCV), 
saliency heuristics, OCR heuristics, and aesthetic proxies.
Neural richness is estimated via proxy, not measured.