🖼️ ImagenHub

March 14, 2025 · View on GitHub

arXiv

Docs

contributors license GitHub Hits

ImagenHub: Standardizing the evaluation of conditional image generation models
ICLR 2024

ImagenHub is a one-stop library to standardize the inference and evaluation of all the conditional image generation models.

  • We define 7 prominent tasks and curate 7 high-quality evaluation datasets for each task.
  • We built a unified inference pipeline to ensure fair comparison. We currently support over 50 models.
  • We designed two human evaluation scores, i.e. Semantic Consistency and Perceptual Quality, along with comprehensive guidelines to evaluate generated images.
  • We provide code for visualization, autometrics and Amazon mechanical turk templates.
[🌐 Project Page] [📘 Documentation] [📄 Arxiv] [💾 Datasets] [🏛️ ImagenMuseum] [⚔️ GenAI-Arena]

📰 News

📄 Table of Contents

🛠️ Installation 🔝

Install from PyPI:

pip install imagen-hub

Or build from source:

git clone https://github.com/TIGER-AI-Lab/ImagenHub.git
cd ImagenHub
conda env create -f env_cfg/imagen_environment.yml
conda activate imagen
pip install -e .

For models like Dall-E, DreamEdit, and BLIPDiffusion, please see Extra Setup

For some models (Stable Diffusion, SDXL, CosXL, etc.), you need to login through huggingface-cli.

huggingface-cli login

👨‍🏫 Get Started 🔝

Benchmarking

To reproduce our experiment reported in the paper:

Example for text-guided image generation:

python3 benchmarking.py -cfg benchmark_cfg/ih_t2i.yml

Note that the expected output structure would be:

result_root_folder
└── experiment_basename_folder
    ├── input (If applicable)
    │   └── image_1.jpg ...
    ├── model1
    │   └── image_1.jpg ...
    ├── model2
    │   └── image_1.jpg ...
    ├── ...

Then after running the experiment, you can run

python3 visualize.py --cfg benchmark_cfg/ih_t2i.yml

to produce a index.html file for visualization.

The file would look like something like this. We hosted our experiment results on Imagen Museum.

Infering one model

import imagen_hub

model = imagen_hub.load("SDXL")
image = model.infer_one_image(prompt="people reading pictures in a museum, watercolor", seed=1)
image

Running Metrics

from imagen_hub.metrics import MetricLPIPS
from imagen_hub.utils import load_image, save_pil_image, get_concat_pil_images

def evaluate_one(model, real_image, generated_image):
  score = model.evaluate(real_image, generated_image)
  print("====> Score : ", score)

image_I = load_image("https://chromaica.github.io/Museum/ImagenHub_Text-Guided_IE/input/sample_102724_1.jpg")
image_O = load_image("https://chromaica.github.io/Museum/ImagenHub_Text-Guided_IE/DiffEdit/sample_102724_1.jpg")
show_image = get_concat_pil_images([image_I, image_O], 'h')

model = MetricLPIPS()
evaluate_one(model, image_I, image_O) # ====> Score :  0.11225218325853348

show_image

📘 Documentation 🔝

The tutorials and API documentation are hosted on imagenhub.readthedocs.io.

🧠 Philosophy 🔝

By streamlining research and collaboration, ImageHub plays a pivotal role in propelling the field of Image Generation and Editing.

  • Purity of Evaluation: We ensure a fair and consistent evaluation for all models, eliminating biases.
  • Research Roadmap: By defining tasks and curating datasets, we provide clear direction for researchers.
  • Open Collaboration: Our platform fosters the exchange and cooperation of related technologies, bringing together minds and innovations.

Implemented Models

We included more than 30 Models in image synthesis. See the full list here:

MethodVenueType
Stable Diffusion-Text-To-Image Generation
Stable Diffusion XLarXiv'23Text-To-Image Generation
DeepFloyd-IF-Text-To-Image Generation
OpenJourney-Text-To-Image Generation
Dall-E-Text-To-Image Generation
Kandinsky-Text-To-Image Generation
MagicBrusharXiv'23Text-guided Image Editing
InstructPix2PixCVPR'23Text-guided Image Editing
DiffEditICLR'23Text-guided Image Editing
ImagicCVPR'23Text-guided Image Editing
CycleDiffusionICCV'23Text-guided Image Editing
SDEditICLR'22Text-guided Image Editing
Prompt-to-PromptICLR'23Text-guided Image Editing
Text2LiveECCV'22Text-guided Image Editing
Pix2PixZeroSIGGRAPH'23Text-guided Image Editing
GLIDEICML'22Mask-guided Image Editing
Blended DiffusionCVPR'22Mask-guided Image Editing
Stable Diffusion Inpainting-Mask-guided Image Editing
Stable Diffusion XL Inpainting-Mask-guided Image Editing
TextualInversionICLR'23Subject-driven Image Generation
BLIP-DiffusionarXiv'23Subject-Driven Image Generation
DreamBooth(+ LoRA)CVPR'23Subject-Driven Image Generation
PhotoswaparXiv'23Subject-Driven Image Editing
DreamEditarXiv'23Subject-Driven Image Editing
Custom DiffusionCVPR'23Multi-Subject-Driven Generation
ControlNetarXiv'23Control-guided Image Generation
UniControlarXiv'23Control-guided Image Generation

Comprehensive Functionality

  • Common Metrics for GenAI
  • Visualization tool
  • Amazon Mechanical Turk Templates (Coming Soon)

High quality software engineering standard.

  • Documentation
  • Type Hints
  • Code Coverage (Coming Soon)

🙌 Contributing 🔝

For the Community

Community contributions are encouraged!

ImagenHub is still under development. More models and features are going to be added and we always welcome contributions to help make ImagenHub better. If you would like to contribute, please check out CONTRIBUTING.md.

We believe that everyone can contribute and make a difference. Whether it's writing code 💻, fixing bugs 🐛, or simply sharing feedback 💬, your contributions are definitely welcome and appreciated 🙌

And if you like the project, but just don't have time to contribute, that's fine. There are other easy ways to support the project and show your appreciation, which we would also be very happy about:

  • Star the project
  • Tweet about it
  • Refer this project in your project's readme
  • Mention the project at local meetups and tell your friends/colleagues

For the Researchers:

🖊️ Citation 🔝

Please kindly cite our paper if you use our code, data, models or results:

@inproceedings{
ku2024imagenhub,
title={ImagenHub: Standardizing the evaluation of conditional image generation models},
author={Max Ku and Tianle Li and Kai Zhang and Yujie Lu and Xingyu Fu and Wenwen Zhuang and Wenhu Chen},
booktitle={The Twelfth International Conference on Learning Representations},
year={2024},
url={https://openreview.net/forum?id=OuV9ZrkQlc}
}

@article{ku2023imagenhub,
  title={ImagenHub: Standardizing the evaluation of conditional image generation models},
  author={Max Ku and Tianle Li and Kai Zhang and Yujie Lu and Xingyu Fu and Wenwen Zhuang and Wenhu Chen},
  journal={arXiv preprint arXiv:2310.01596},
  year={2023}
}

🤝 Acknowledgement 🔝

Please refer to ACKNOWLEDGEMENTS.md

🎫 License 🔝

This project is released under the License.

⭐ Star History 🔝

Star History Chart