albumentations-team /albumentations
Fast and flexible image augmentation library. Paper about the library: https://www.mdpi.com/2078-2489/11/2/125
★ 15,296⑂ 1,714👁 2⑃ 1,259● 1,260▤ 51
-1
日增长
15,296
stars
1,714
forks
2
watchers
1,259
prs
1,260
issues
51
releases
README
Albumentations
!CI
📣 Stay updated! Subscribe to our newsletter for the latest releases, tutorials, and tips directly from the Albumentations team.
Docs | Discord | Twitter | LinkedIn
⚠️ Important Notice: Albumentations is No Longer Maintained
This repository is no longer actively maintained. The last update was in June 2025, and no further bug fixes, features, or compatibility updates will be provided.
🚀 Introducing AlbumentationsX - The Future of Albumentations
All development has moved to AlbumentationsX, the next-generation successor to Albumentations.
Note: AlbumentationsX uses dual licensing (AGPL-3.0 / Commercial). The AGPL license has strict copyleft requirements - see details below.
Your Options Moving Forward
1. Continue Using Albumentations (MIT License)
- ✅ Forever free for all uses including commercial
- ✅ No licensing fees or restrictions
- ❌ No bug fixes - Even critical bugs won't be addressed
- ❌ No new features - Missing out on performance improvements
- ❌ No support - Issues and questions go unanswered
- ❌ No compatibility updates - May break with new Python/PyTorch versions
Best for: Projects that work fine with the current version and don't need updates
2. Upgrade to AlbumentationsX (Dual Licensed)
- ✅ Drop-in replacement - Same API, just pip install albumentationsx
- ✅ Active development - Regular updates and new features
- ✅ Bug fixes - Issues are actively addressed
- ✅ Performance improvements - Faster execution
- ✅ Community support - Active Discord and issue tracking
- ⚠️ Dual licensed:
- AGPL-3.0: Free ONLY for projects licensed under AGPL-3.0 (not compatible with MIT, Apache, BSD, etc.)
- Commercial License: Required for proprietary use AND permissive open-source projects
Best for: Projects that need ongoing support, updates, and new features
⚠️ AGPL License Warning: The AGPL-3.0 license is NOT compatible with permissive licenses like MIT, Apache 2.0, or BSD. If your project uses any of these licenses, you CANNOT use the AGPL version of AlbumentationsX - you'll need a commercial license.
Migration is Simple
bash
Uninstall original
pip uninstall albumentations
Install AlbumentationsX
pip install albumentationsx
That's it! Your existing code continues to work without any changes:
python
import albumentations as A Same import!
transform = A.Compose([
A.RandomCrop(width=256, height=256),
A.HorizontalFlip(p=0.5),
A.RandomBrightnessContrast(p=0.2),
])
Learn More
- 📦 AlbumentationsX Repository:
- 💰 Commercial Licensing:
- 💬 Discord Community:
---
Original Albumentations README
GitAds Sponsored
Albumentations is a Python library for image augmentation. Image augmentation is used in deep learning and computer vision tasks to increase the quality of trained models. The purpose of image augmentation is to create new training samples from the existing data.
Here is an example of how you can apply some pixel-level augmentations from Albumentations to create newDiscussions
#2565Diagram visualization of the albumentations codebase0 comments · 2025-06-18#2544Why is HueSaturationValue needed when ColorJitter can do the same?1 comments · 2025-05-31#2478Tint and Temperature Tweaking1 comments · 2025-03-18#2342How to Ensure Reproducibility?1 comments · 2025-02-16#2274Emdeddable "Ask AI" widget for Albumentations Guru0 comments · 2025-01-16#2272Problems with SmallestMaxSize and LongestMaxSize1 comments · 2025-01-15#2184how do I disable multiprocessing?1 comments · 2024-12-11#2170Albumentations compatibility with obb format3 comments · 2024-11-27
Latest release
🛠 Albumentations 2.0.8 Release Notes 2.0.8 2025-05-27Want to stay in the loop? Get updates on new features, documentation changes, and tools like the UI explorer by subscribing to our mailing list: 👉 https://albumentations.ai/subscribe/ You can unsubscribe anytime. --- 💖 Support Our Work 1. Help Us Grow – Found Albumentations useful? Become a sponsor to support ongoing development. 2. Show Your Support – A ⭐ on GitHub helps others discover us. 3. Join the Community – Report issues or suggest improvements via GitHub Issues or join discussions on Discord. Improvements Added area_for_downscale to RandomResizedCrop and Rando