Skip to main content

ImageReward

Project description

ImageReward-Pypi

ImageReward is the first general-purpose text-to-image human preference RM which is trained on in total 137k pairs of expert comparisons, based on text prompts and corresponding model outputs from DiffusionDB. We demonstrate that ImageReward outperforms existing text-image scoring methods, such as CLIP, Aesthetic, and BLIP, in terms of understanding human preference in text-to-image synthesis through extensive analysis and experiments.

Usage

import os
import torch
import ImageReward as reward

if __name__ == "__main__":
    prompt = "a painting of an ocean with clouds and birds, day time, low depth field effect"
    img_prefix = "assets/images"
    generations = [f"{pic_id}.webp" for pic_id in range(1, 5)]
    img_list = [os.path.join(img_prefix, img) for img in generations]
    model = reward.load()
    with torch.no_grad():
        ranking, rewards = model.inference_rank(prompt, img_list)
        # Print the result
        print("\nPreference predictions:\n")
        print(f"ranking = {ranking}")
        print(f"rewards = {rewards}")
        for index in range(len(img_list)):
            score = model.score(prompt, img_list[index])
            print(f"{generations[index]:>16s}: {score:.2f}")

The output will look like the following (the exact numbers may be slightly different depending on the compute device):

Preference predictions:

ranking = [1, 2, 3, 4]
rewards = [[0.5811622738838196], [0.2745276093482971], [-1.4131819009780884], [-2.029569625854492]]
          1.webp: 0.58
          2.webp: 0.27
          3.webp: -1.41
          4.webp: -2.03

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

image-reward-0.94.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

image_reward-0.94-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file image-reward-0.94.tar.gz.

File metadata

  • Download URL: image-reward-0.94.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.16

File hashes

Hashes for image-reward-0.94.tar.gz
Algorithm Hash digest
SHA256 c99dd477c05e0b97092ffb1dbdd1c6386771f826e8c55adde008973bed81264a
MD5 52489169840e204914bc3de8d8feb257
BLAKE2b-256 987febef498bbeab722d49210eca1155ae76fc6284b205d9010e16a7d93c5389

See more details on using hashes here.

File details

Details for the file image_reward-0.94-py3-none-any.whl.

File metadata

  • Download URL: image_reward-0.94-py3-none-any.whl
  • Upload date:
  • Size: 5.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.16

File hashes

Hashes for image_reward-0.94-py3-none-any.whl
Algorithm Hash digest
SHA256 6b21b90cd1792dc6aa79d9495dd0538362079594d8ab6118d4baa0b9909262ce
MD5 03509a362d3fc53b16ed44c87d15a88c
BLAKE2b-256 02c71bd4cafc2dfc171ada05811ecd9333d4db1497298aa6845c6b17cf1f791c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page