clusteval is a python package for unsupervised cluster validation.

clustering, dbindex, density-based-clustering, machine-learning, python, silhouette-method, unsupervised-clustering, validation
pip install clusteval==2.1.4



Python PyPI Version License BuyMeCoffee Github Forks GitHub Open Issues Project Status Downloads Downloads DOI Sphinx Open In Colab

clusteval is a python package that is developed to evaluate detected clusters and return the cluster labels that have most optimal clustering tendency, Number of clusters and clustering quality. Multiple evaluation strategies are implemented for the evaluation; silhouette, dbindex, and derivative, and four clustering methods can be used: agglomerative, kmeans, dbscan and hdbscan.

⭐️ Star this repo if you like it ⭐️


Read the blog to get a structured overview how you can use clusteval.

In case you want to detect identical images, you can also use hash functionalities.

Documentation pages

On the documentation pages you can find detailed information about the working of the clusteval with many examples.


It is advisable to create a new environment (e.g. with Conda).
conda create -n env_clusteval python=3.8
conda activate clusteval
Install from PyPI
pip install clusteval
Import library
from clusteval import clusteval


A structured overview of all examples are now available on the documentation pages.


Please cite clusteval in your publications if this is useful for your research (see right top for citation).

Other interesting techniques/blogs


  • Erdogan Taskesen, github: erdogant
  • Contributions are welcome.
  • If you wish to buy me a Coffee for this work, it is very appreciated :) Star it if you like it!