A simple, high level, easy to use, open source Computer Vision library for Python.

This project is maintained by arunponnusamy


A high level easy-to-use open source Computer Vision library for Python.

It was developed with a focus on enabling easy and fast experimentation. Being able to go from an idea to prototype with least amount of delay is key to doing good research.

Guiding principles of cvlib are heavily inspired from Keras (deep learning library).


Provided the below python packages are installed, cvlib is completely pip installable.

Install the required packages using the below command

pip install -r requirements.txt

pip install cvlib

To upgrade to the newest version pip install --upgrade cvlib

If you are using a GPU, edit the requirements.txt file (available in the github repo) to install tensorflow-gpu instead of tensorflow.

Face detection

Detecting faces in an image is as simple as just calling the function detect_face(). It will return the bounding box corners and corresponding confidence for all the faces detected.

Example :

import cvlib as cv
faces, confidences = cv.detect_face(image) 

Seriously, that’s all it takes to do face detection with cvlib. Underneath it is using OpenCV’s dnn module with a pre-trained caffemodel to detect faces.

Checkout the github repo to learn more.

Gender detection

Once face is detected, it can be passed on to detect_gender() function to recognize gender. It will return the labels (man, woman) and associated probabilities.


label, confidence = cv.detect_gender(face)

Underneath cvlib is using a pre-trained keras model to detect gender from face. The accuracy is not so great at this point. It still makes mistakes. Working on adding a more accurate model.

Checkout in examples directory for the complete code.

Object detection

Detecting common objects in the scene is enabled through a single function call detect_common_objects(). It will return the bounding box co-ordinates, corrensponding labels and confidence scores for the detected objects in the image.

Example :

import cvlib as cv
from cvlib.object_detection import draw_bbox

bbox, label, conf = cv.detect_common_objects(img)

output_image = draw_bbox(img, bbox, label, conf)

Underneath it uses YOLOv3 model trained on COCO dataset capable of detecting 80 common objects in context.

Checkout the github repo to learn more.


Feel free to create a new issue on github if you are facing any difficulty.


cvlib is released under MIT License.


Feel free to drop an email or reach out on Twitter.