Science Score: 65.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
    Organization som-research has institutional domain (som-research.uoc.edu)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.0%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: SOM-Research
  • License: mit
  • Language: Python
  • Default Branch: main
  • Size: 58.6 KB
Statistics
  • Stars: 3
  • Watchers: 2
  • Forks: 0
  • Open Issues: 0
  • Releases: 1
Created over 1 year ago · Last pushed 7 months ago
Metadata Files
Readme License Code of conduct Citation Governance

README.md

ImageBiTe: A Bias Tester framework for T2I Models

ImageBiTe is a framework for testing representational harms in text-to-image (T2I) models. Given an ethical requirements model, ImageBiTe prompts a T2I model and evaluates the output in order to detect stereotyping, under-representation, ex-nomination and denigration of protected groups. It includes a library of prompts to test sexism, racism, ageism, and discrimination with regard to physical impairments. Any contributor is welcome to add new ethical concerns to assess and their prompt templates.

Code Repository Structure

The following tree shows the list of the repository's sections and their main contents:

└── imagebite // The source code of the package. ├── imagebite.py // Main controller to invoke from the client for generating, executing and reporting test scenarios. └── resources ├── factories.json // Endpoints for invoking and testing online T2I models. ├── generic_validators.json // Prompts for generic, qualitative evaluation of generated images. └── prompts_t2i_CO_RE.csv // The prompt templates libraries in CSV format.

Requirements

  • huggingface-hub 0.26.1
  • numpy 2.1.2
  • openai 1.52.1
  • pandas 2.2.3
  • pillow 11.0.0
  • python-dotenv 1.0.1
  • PyGithub 2.4.0
  • requests 2.32.3

Your project needs the following keys in the .env file:

  • APIKEYOPENAI, to properly connect to OpenAI's API and models.
  • APIKEYHUGGINGFACE, to properly invoke Inference APIs in HuggingFace.
  • GITHUB_REPO, the name of the public repository where to upload generated images.
  • GITHUBREPOPREFIX, the URL of the public repository where to upload generated images.
  • GITHUB_TOKEN, to properly connect to the GitHub repository.

Governance and Contribution

The development and community management of this project follows the governance rules described in the GOVERNANCE.md document.

At SOM Research Lab we are dedicated to creating and maintaining welcoming, inclusive, safe, and harassment-free development spaces. Anyone participating will be subject to and agrees to sign on to our CODEOFCONDUCT.md.

This project is part of a research line of the SOM Research Lab, but we are open to contributions from the community. Any comment is more than welcome! If you are interested in contributing to this project, please read the CONTRIBUTING.md file.

Publications

Related publications:

Sergio Morales, Robert Clarisó and Jordi Cabot, "ImageBiTe: A Framework for Evaluating Representational Harms in Text-to-Image Models," 2025 IEEE/ACM 4th International Conference on AI Engineering – Software Engineering for AI (CAIN), Ottawa, ON, Canada, 2025, pp. 95-106, doi: 10.1109/CAIN66642.2025.00019.

License

License: MIT

The source code for the site is licensed under the MIT License, which you can find in the LICENSE.md file.

Owner

  • Name: SOM Research Lab
  • Login: SOM-Research
  • Kind: organization
  • Email: rclariso@uoc.edu
  • Location: Barcelona

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - family-names: Morales
    given-names: Sergio
    orcid: https://orcid.org/0000-0002-5921-9440
title: "ImageBiTe: A Framework for Evaluating Representational Harms in Text-to-Image Models"
version: 1.0.0
license: MIT
date-released: 2024-10-27

GitHub Events

Total
  • Watch event: 3
  • Member event: 1
  • Public event: 1
  • Push event: 5
  • Create event: 2
Last Year
  • Watch event: 3
  • Member event: 1
  • Public event: 1
  • Push event: 5
  • Create event: 2