cleanvision

cleanlabApache-2.0更新放缓

自动扫描图像数据集,找出重复、模糊、曝光异常等质量问题,帮你在训练前把数据清洗干净。

Automatically find issues in image datasets and practice data-centric computer vision.

v0.3.7发布于 2026-01-05 23:54 UTC1,212star87fork同步于 2026-11-07 07:31 UTC

怎么上手

由 README 提炼,执行前请确认
pip install cleanvision
硬件要求按 README 说明

README 未说明显存或 GPU 要求,仅说明支持 Linux、macOS、Windows,需 Python 3.10+

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

用几行 Python 代码自动审计图像数据集,在训练模型前找出模糊、重复、过曝等脏数据

自动扫描图像数据集,找出重复、模糊、曝光异常等质量问题,帮你在训练前把数据清洗干净。

核心能力

  • 用 find_issues 自动检测预定义的一整套图像问题
  • 支持按 issue_types 只检查指定问题类型
  • 可检测完全重复与视觉近似重复的图片
  • 识别模糊、过暗过亮、低信息量、灰度图
  • 检测异常长宽比与相对数据集异常尺寸

容易踩的坑

需 Python 3.10 及以上版本;示例数据集需另行用 wget 下载,或自备图片文件夹;只检测原始图像本身的问题,标签问题需改用 cleanlab 包

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.3.7
  1. v0.3.7v0.3.7 -- more permissive license, better output-control最新正式版2026-01-05 · 2026-01-05 23:54 UTC

    This version of CleanVision updates the License to be more permissive (Apache 2.0), and also offers better control of printed outputs/verbosity.

    What's Changed

    New Contributors

    Full Changelog: https://github.com/cleanlab/cleanvision/compare/v0.3.6...v0.3.7

  2. v0.3.6v0.3.6 Improved issue type odd_size, minor bug fix and version updates2024-02-13 · 2024-02-13 19:00 UTC
    查看更新说明
    • Odd size issue We use the IQR method now instead of a hard threshold to detect odd sized images compared to the rest of the dataset. According to this, an image is marked as odd sized if size > q1 + 3 * IQR or size < q3 - 3 * IQR, where q1 and q3 are the 25th and 75th percentiles respectively.
    • Statistics imagelab.info['statistics'] is now updated to provide key statistics like mean, std, min, max, 25%, 50%, and 75% for all the image properties being computed while looking for issues.
    • Bug fix Image was being resized to zero width/height for blurry issue check, in cases where aspect ratio was unusual.
    • CI pipeline Version updates for black, flake8 docs requirements and datasets library. Added cron schedule for running tests.

    Related PRs

    Full Changelog: https://github.com/cleanlab/cleanvision/compare/v0.3.5...v0.3.6

  3. v0.3.5v0.3.5 Improved documentation, enhanced testing, and codebase refinements2023-11-30 · 2023-11-30 15:38 UTC
    查看更新说明
    • Improved README, added FAQ page and updated Development guide with instructions for building docs.
    • Added tests for truncating titles in visualization, updated dev requirements, and fixed type checking issue.
    • Added code for raising exception on receiving duplicate files in filepaths argument.
    • Added a PR template

    Detailed changes

    New Contributors

    Full Changelog: https://github.com/cleanlab/cleanvision/compare/v0.3.4...v0.3.5

  4. v0.3.4v0.3.4 Improved time taken to find issues in large datasets.2023-09-01 · 2023-09-01 11:12 UTC
    查看更新说明

    Improved time taken to find issues in large datasets.

    What's Changed

    Full Changelog: https://github.com/cleanlab/cleanvision/compare/v0.3.3...v0.3.4

  5. v0.3.3v.0.3.3 Added support for cloud datasets2023-08-09 · 2023-08-09 06:00 UTC
    查看更新说明

    Added support for running cleanvision on datasets residing in cloud, AWS, Google storage and Azure storage.

    What's Changed

    New Contributors

    Full Changelog: https://github.com/cleanlab/cleanvision/compare/v0.3.2...v0.3.3

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    CleanVision automatically detects potential issues in image datasets like images that are: blurry, under/over-exposed, (near) duplicates, etc. This data-centric AI package is a quick first step for any computer vision project to find problems in the dataset, which you want to address before applying machine learning. CleanVision is super simple -- run the same couple lines of Python code to audit any image dataset!

    Read the Docs pypi os py_versions codecov

    Installation

    pip install cleanvision
    

    Quickstart

    Download an example dataset (optional). Or just use any collection of image files you have.

    wget -nc 'https://cleanlab-public.s3.amazonaws.com/CleanVision/image_files.zip'
    
    1. Run CleanVision to audit the images.
    from cleanvision import Imagelab
    
    # Specify path to folder containing the image files in your dataset
    imagelab = Imagelab(data_path="FOLDER_WITH_IMAGES/")
    
    # Automatically check for a predefined list of issues within your dataset
    imagelab.find_issues()
    
    # Produce a neat report of the issues found in your dataset
    imagelab.report()
    
    1. CleanVision diagnoses many types of issues, but you can also check for only specific issues.
    issue_types = {"dark": {}, "blurry": {}}
    
    imagelab.find_issues(issue_types=issue_types)
    
    # Produce a report with only the specified issue_types
    imagelab.report(issue_types=issue_types)
    

    More resources

    Clean your data for better Computer Vision

    The quality of machine learning models hinges on the quality of the data used to train them, but it is hard to manually identify all of the low-quality data in a big dataset. CleanVision helps you automatically identify common types of data issues lurking in image datasets.

    This package currently detects issues in the raw images themselves, making it a useful tool for any computer vision task such as: classification, segmentation, object detection, pose estimation, keypoint detection, generative modeling, etc. To detect issues in the labels of your image data, you can instead use the cleanlab package.

    In any collection of image files (most formats supported), CleanVision can detect the following types of issues:

    Issue TypeDescriptionIssue KeyExample
    1Exact DuplicatesImages that are identical to each otherexact_duplicates
    2Near DuplicatesImages that are visually almost identicalnear_duplicates
    3BlurryImages where details are fuzzy (out of focus)blurry
    4Low InformationImages lacking content (little entropy in pixel values)low_information
    5DarkIrregularly dark images (underexposed)dark
    6LightIrregularly bright images (overexposed)light
    7GrayscaleImages lacking colorgrayscale
    8Odd Aspect RatioImages with an unusual aspect ratio (overly skinny/wide)odd_aspect_ratio
    9Odd SizeImages that are abnormally large or small compared to the rest of the datasetodd_size

    CleanVision supports Linux, macOS, and Windows and runs on Python 3.10+. Learn more from our blog.

    Have a question?

    Search the resources listed above and existing GitHub Issues, or submit a new Issue.