Skip to main content
SAHI logo

SAHI: Slicing Aided Hyper Inference

A lightweight vision library for performing large scale object detection & instance segmentation

teaser

Total Downloads Monthly Downloads PyPI Version Conda Version License
CI Known Vulnerabilities CodeFactor DOI
Context7 MCP llms.txt DeepWiki HuggingFace Spaces

Overview

SAHI helps developers overcome real-world challenges in object detection by enabling sliced inference for detecting small objects in large images. It supports various popular detection models and provides easy-to-use APIs.

🌐 English | 🇨🇳 简体中文 | 🇹🇷 Türkçe

Command Description
predict Perform sliced/standard video/image prediction using any ultralytics / mmdet / huggingface / torchvision model, see CLI guide
predict-fiftyone Perform sliced/standard prediction using any supported model and explore results in fiftyone app, learn more
coco slice Automatically slice COCO annotation and image files, see slicing utilities
coco fiftyone Explore multiple prediction results on your COCO dataset with fiftyone ui ordered by number of misdetections
coco evaluate Evaluate classwise COCO AP and AR for given predictions and ground truth, check COCO utilities
coco analyse Calculate and export many error analysis plots, see the complete guide
coco yolo Automatically convert any COCO dataset to ultralytics format

Approved by the Community

📜 List of publications that cite SAHI (currently 600+)

🏆 List of competition winners that used SAHI

Approved by AI Tools

SAHI's documentation is indexed in Context7 MCP, providing AI coding assistants with up-to-date, version-specific code examples and API references. We also provide an llms.txt file following the emerging standard for AI-readable documentation. To integrate SAHI docs with your AI development workflow, check out the Context7 MCP installation guide.

Installation

Basic Installation

pip install sahi
Detailed Installation (Click to open)
  • Install your desired version of pytorch and torchvision:
pip install torch==2.13.0 torchvision==0.28.0 --index-url https://download.pytorch.org/whl/cu130

(torch 2.1.2 is required for mmdet support):

pip install torch==2.1.2 torchvision==0.16.2 --index-url https://download.pytorch.org/whl/cu121
  • Install your desired detection framework (ultralytics):
pip install ultralytics>=8.3.161
  • Install your desired detection framework (huggingface):
pip install transformers>=4.49.0 timm
  • Install your desired detection framework (yolov5):
pip install yolov5==7.0.14 sahi==0.12.1
  • Install your desired detection framework (mmdet):
pip install mim
mim install mmdet==3.3.0
  • Install your desired detection framework (roboflow):
pip install inference>=0.51.5 rfdetr>=1.6.2

Quick Start

Learning Resources

Resource Type
Introduction to SAHI Blog Post
2025 Video Tutorial ⭐ Video
Official Paper (ICIP 2022 oral) Paper
Pretrained Weights & ICIP 2022 Paper Files Benchmark
Visualizing and Evaluating SAHI Predictions with FiftyOne Blog Post
Exploring SAHI on learnopencv.com Article
Slicing Aided Hyper Inference Explained by Encord Article
Video Tutorial: SAHI for Small Object Detection Video
Satellite Object Detection Blog Post
COCO Dataset Conversion Blog Post
Kaggle Notebook Notebook
Error Analysis Plots & Evaluation ⭐ Discussion
Interactive Result Visualization and Inspection ⭐ Discussion
Video Inference Support Discussion
Slicing Operation Notebook Notebook
Complete Documentation Docs

Notebooks & Demos

Framework Notebook Demo
YOLO26 Open In Colab -
YOLO11 Open In Colab -
YOLO11-OBB Open In Colab -
YOLOE Open In Colab -
Roboflow / RF-DETR Open In Colab -
RT-DETR v2 Open In Colab -
RT-DETR Open In Colab -
HuggingFace Open In Colab -
GroundingDINO Open In Colab -
YOLOv5 Open In Colab -
MMDetection Open In Colab -
Detectron2 Open In Colab -
TorchVision Open In Colab -
YOLOX - HuggingFace Spaces

sahi-yolox

Framework Agnostic Sliced/Standard Prediction

sahi-predict

Find detailed info on using sahi predict command in the CLI documentation and explore the prediction API for advanced usage.

Find detailed info on video inference at video inference tutorial.

Error Analysis Plots & Evaluation

sahi-analyse

Find detailed info at Error Analysis Plots & Evaluation.

Interactive Visualization & Inspection

sahi-fiftyone

Explore FiftyOne integration for interactive visualization and inspection.

Other Utilities

Check the comprehensive COCO utilities guide for YOLO conversion, dataset slicing, subsampling, filtering, merging, and splitting operations. Learn more about the slicing utilities for detailed control over image and dataset slicing parameters.

Citation

If you use this package in your work, please cite as:

@article{akyon2022sahi,
  title={Slicing Aided Hyper Inference and Fine-tuning for Small Object Detection},
  author={Akyon, Fatih Cagatay and Altinuc, Sinan Onur and Temizel, Alptekin},
  journal={2022 IEEE International Conference on Image Processing (ICIP)},
  doi={10.1109/ICIP46576.2022.9897990},
  pages={966-970},
  year={2022}
}
@software{obss2021sahi,
  author       = {Akyon, Fatih Cagatay and Cengiz, Cemil and Altinuc, Sinan Onur and Cavusoglu, Devrim and Sahin, Kadir and Eryuksel, Ogulcan and Sezer, Onuralp},
  title        = {{SAHI: A lightweight vision library for performing large scale object detection and instance segmentation}},
  month        = nov,
  year         = 2021,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.5718950},
  url          = {https://doi.org/10.5281/zenodo.5718950}
}

Contributing

We welcome contributions! Please see our Contributing Guide to get started. Thank you 🙏 to all our contributors!

Metadata

Release files for sahi 0.13.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sahi 0.13.1
File Size Uploaded Provenance Actions
sahi-0.13.1.tar.gz 4.8 MB Without provenance Details for sahi-0.13.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sahi 0.13.1
File Interpreter ABI Platform Actions
sahi-0.13.1-py3-none-any.whl Python 3 none any Details for sahi-0.13.1-py3-none-any.whl

Total release size: 4.9 MB

Release files / sahi-0.13.1.tar.gz

Download URL sahi-0.13.1.tar.gz
Size 4.8 MB
Tags Source
SHA-256 checksum
How to use checksums
88c1858b09e7b0066f1e63cd8271285d09c7943925615e4ce20cf61223782735
BLAKE2b-256 checksum
How to use checksums
ed0de32232d64d03fe03808426e03a51bcebc18f412c2366c52d23498faf44cf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / sahi-0.13.1-py3-none-any.whl

Download URL sahi-0.13.1-py3-none-any.whl
Size 156.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9698894d823ee66ed9c6bcb1ba6371d595d98bae6aeb86a5f1f90d76e6452463
BLAKE2b-256 checksum
How to use checksums
9b77b9cf34dbc333713e3bc25d41f652185aee9314229e10faa667a65902a40e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for sahi 0.13.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.13.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page