Awesome

<p align="center"> <img alt="giskardlogo" src="https://raw.githubusercontent.com/giskard-ai/giskard/main/readme/giskard_logo.png#gh-light-mode-only"> <img alt="giskardlogo" src="https://raw.githubusercontent.com/giskard-ai/giskard/main/readme/giskard_logo_green.png#gh-dark-mode-only"> </p> <h1 align="center" weight='300' >The testing framework dedicated to Computer Vision models.</h1> <h3 align="center" weight='300' >Detect risks of biases, performance issues and errors in your computer vision models. </h3> <div align="center">

</div> <h3 align="center"> <a href="https://docs.giskard.ai/en/latest/index.html"><b>Documentation</b></a> • <a href="https://www.giskard.ai/knowledge-categories/blog/?utm_source=github&utm_medium=github&utm_campaign=github_readme&utm_id=readmeblog"><b>Blog</b></a> • <a href="https://www.giskard.ai/?utm_source=github&utm_medium=github&utm_campaign=github_readme&utm_id=readmeblog"><b>Website</b></a> • <a href="https://gisk.ar/discord"><b>Discord Community</b></a> • <a href="https://www.giskard.ai/about?utm_source=github&utm_medium=github&utm_campaign=github_readme&utm_id=readmeblog#advisors"><b>Advisors</b></a> </h3> <br />

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.

Getting Started

To get the most out of Giskard Vision, we recommend starting with these essential guides in our documentation:

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:

Install the repository in development mode.
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

→ For Linux users with CUDA support

It is recommended that you install the following CUDA-compatible versions of Torch by running the command below:

pdm run pip install -U torch==2.1.0+cu121 torchvision==0.16.0+cu121 --index-url https://download.pytorch.org/whl/cu121