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
PythonMITCreated 2018-06-06albumentations.ai
Download: 🛠 Albumentations 2.0.8 Release Notes🛠-2.0.8 ↓2.0.82025-05-27
-1
Daily
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 new

Discussions

Latest release

🛠 Albumentations 2.0.8 Release Notes 2.0.8 2025-05-27
Want 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON