Style_Sync / README.md
heramb04's picture
Update README.md
b54ae8d verified
---
title: Style Sync
emoji: ๐Ÿ 
colorFrom: pink
colorTo: gray
sdk: gradio
sdk_version: 5.36.2
app_file: app.py
pinned: false
license: mit
short_description: Fuses 2 paintings/images
---
---
## ๐ŸŽจ Neural Style Transfer โ€” A + B = C
Ever wondered what Van Goghโ€™s brush would look like on your selfie? Or how a castle would look reimagined in Picassoโ€™s palette? **This app lets you do exactly that.**
Upload your own images or remix iconic paintings using **neural style transfer** โ€” a deep learning technique that fuses the *content* of one image with the *style* of another. Watch `A + B = C` come to life in real time.
---
### ๐Ÿš€ Features
- **โœจ Stylize Your Own Images**
Upload any two images: one for content, one for style. The result? A stunning hybrid visual that blends their essence.
- **๐ŸŽฒ Pick Random Pairings**
Not sure what to try? Click *"Pick Random & Generate"* to randomly fuse masterpieces from the [Famous Paintings](https://huggingface.co/datasets/heramb04/Famous-paintings) dataset.
- **๐Ÿงช Adjustable Optimization**
Slide between fast runs and deep stylization with the step slider (100โ€“500 iterations).
- **๐Ÿ–Œ๏ธ Triptych Output** *(coming soon)*
Visualize the fusion in a layout: `Content + Style = Output`.
---
### ๐Ÿง  How It Works
Under the hood, this app leverages:
- `torchvision`'s pretrained **VGG-19** model
- **Content and style loss modules** with Gram matrices
- **LBFGS optimizer** for iterative refinement
- Hosted on Hugging Face Spaces using Gradio
No pretraining or model uploads needed โ€” everything runs on-the-fly.
---
### ๐Ÿ“ Dataset
This app uses [Famous Paintings](https://huggingface.co/datasets/heramb04/Famous-paintings) hosted on Hugging Face Datasets โ€” curated for visual diversity and artistic flair.
You can remix any pair of artworks, or contribute your own.
---
### ๐Ÿ› ๏ธ Requirements
This app installs the following Python packages:
```
torch
torchvision
gradio
Pillow
datasets
matplotlib
```
---
### ๐Ÿ’ก Credits & Collaboration
Built by [Heramb Joshi]
Feel free to fork, remix, or contribute ideas! Pull requests, dataset expansions, and UI upgrades are welcome.
---