OpenOOD  by Jingkang50

OOD benchmark for generalized out-of-distribution detection

Created 4 years ago
1,081 stars

Top 35.2% on SourcePulse

GitHubView on GitHub
Project Summary

OpenOOD provides a comprehensive benchmark and framework for evaluating generalized Out-of-Distribution (OOD) detection methods. It aims to standardize fair comparisons across diverse OOD detection techniques, including anomaly detection, novelty detection, and open-set recognition. The project targets researchers and practitioners in machine learning, particularly those working on robust and reliable AI systems.

How It Works

OpenOOD implements a unified evaluator that simplifies the process of benchmarking OOD detection methods. It supports a wide range of datasets, backbones (CNNs and Transformers), and over 60 OOD detection algorithms, categorized by their approach (e.g., post-hoc, training-based, extra data). The framework allows for automatic hyperparameter searching and provides pre-trained checkpoints for common datasets.

Quick Start & Requirements

  • Installation: pip install git+https://github.com/Jingkang50/OpenOOD
  • Optional: pip install libmr for CLIP, pip install git+https://github.com/openai/CLIP.git for CLIP.
  • Data: Benchmarks are automatically downloaded by the evaluator; training data requires a separate download script.
  • Pre-trained Models: Available for CIFAR-10, CIFAR-100, ImageNet-200, and ImageNet-1K.
  • Resources: Official colab tutorial available.

Highlighted Details

  • Supports 10 benchmark datasets, including CIFAR-10/100, ImageNet-1K/200, and TinyImageNet.
  • Integrates 6 backbone architectures like ResNet and ViT, with pre-trained weights.
  • Implements over 60 OOD detection methods, covering various categories and techniques.
  • Includes support for foundation models like zero-shot CLIP and DINOv2.

Maintenance & Community

The project is actively under development, with recent updates including v1.5 release and acceptance to DMLR. Contributions and collaborations are welcomed.

Licensing & Compatibility

The repository does not explicitly state a license in the README. Users should verify licensing for commercial use or integration into closed-source projects.

Limitations & Caveats

The README states the codebase is "still under construction," indicating potential for ongoing changes and instability. Specific licensing information is not readily available.

Health Check
Last Commit

10 months ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
0
Star History
2 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.