README.md

---
title: Visual Rhetoric Analyzer
emoji: 🎨
colorFrom: red
colorTo: yellow
sdk: gradio
app_file: app.py
pinned: false
---

# Visual Rhetoric & Composition Analyzer

An interactive computational tool designed for visual social science, media framing analysis, political communication, and digital humanities to audit visual bias, compositional structures, and dominant color palettes.

### Features
1. **Interactive K-Means Palettes**: Automatically clusters image pixels to extract the top 5 dominant colors with complete visual psychology and framing interpretations.
2. **Rule-of-Thirds Composition Overlay**: Draws vertical and horizontal grid lines, highlights focal power intersections, and calculates visual center-of-gravity weights using Canny edges.
3. **Luminance & Contrast Histograms**: Plots image brightness curves and mathematically classifies the image's lighting style (e.g., High-Key, Low-Key, or Mid-Key standard).
4. **Instant Local Computation**: Runs entirely locally using OpenCV, NumPy, and Scikit-Learn for ultra-fast, zero-overhead computation that starts up immediately on basic CPU hardware.