Skip to content

Giskard-AI/giskard-vision

Repository files navigation

giskardlogo giskardlogo

The testing framework dedicated to ML models.

Detect risks of biases, performance issues and errors in your computer vision models.

GitHub release License Full CI

Giskard on Discord


Giskard Vision is a comprehensive Python package designed to simplify and streamline a variety of computer vision tasks. Whether you're working on facial landmark detection, image classification, or object detection, Giskard Vision provides the tools you need to evaluate your models with ease.

Supported Computer Vision Tasks

  • Facial Landmark Detection (Readme)
  • Image Classification (Readme)
  • Object Detection (Readme)

Installation

To install Giskard Vision, simply use pip:

pip install giskard-vision

If you want to contribute to the development or explore the latest features, you can install the repository in development mode:

git clone https://github.com/Giskard-AI/giskard-vision.git
cd giskard-vision
pdm install -G :all
source .venv/bin/activate

Scan

Giskard Vision includes powerful scanning capabilities to evaluate your models. To run a scan, first ensure that you have the giskard library installed:

pip install giskard

Then, you can perform a scan using the following code:

from giskard_vision import scan

dataloader = ...
model = ...

results = scan(model, dataloader)

Explore the examples provided to see how to implement scans in different contexts:

Examples

The examples directory contains Jupyter notebook tutorials that demonstrate how to use Giskard Vision for various tasks. To explore these tutorials:

  1. Install the repository in development mode.
  2. Navigate to the examples directory and open the notebook of interest.

FAQ

I am getting attributeerror: module 'cv2.face' has no attribute 'createlbphfacerecognizer' when running some examples in dev mode

This issue usually occurs due to the installation order of the opencv-contrib-python module. To resolve it, follow these steps:

pip uninstall opencv-contrib-python
pip install opencv-contrib-python