YOLO formatında veri seti etiketleme için ücretsiz, açık kaynaklı masaüstü uygulaması
Free, open-source desktop annotation tool for YOLO-format datasets
TR Türkçe | EN English
Annotie, YOLO formatında veri seti oluşturmak ve yönetmek için geliştirilmiş masaüstü görsel etiketleme uygulamasıdır. Tüm YOLO görev tiplerini tek bir araçta destekler -- abonelik yok, limit yok, bulut yüklemesi yok.
| Tip | YOLO Görevi |
|---|---|
| Bounding Box (BBox) | Detection (Nesne Tespiti) |
| Polygon | Segmentation (Segmentasyon) |
| Oriented Bounding Box (OBB) | OBB Detection |
| Keypoints | Pose Estimation (Poz Tahmini) |
| Classification | Image Classification (Görüntü Sınıflandırma) |
Aynı veri setinde farklı etiket tipleri bir arada kullanılabilir. YOLOv5, v8, v10, v11, v12 ve sonrası ile uyumludur.
Annotie, birden fazla kişinin aynı veri seti üzerinde eş zamanlı çalışmasına olanak tanır -- aynı odada veya dünya üzerinde farklı lokasyonlarda.
Nasıl Çalışır:
- Bir kullanıcı Lobi Oluştur'a tıklar, 6 haneli bir kod üretilir
- Diğer kullanıcılar bu kodu girerek lobiye katılır
- Tüm annotation değişiklikleri (oluşturma, silme, taşıma, sınıf değiştirme) anlık olarak senkronize edilir
Özellikler:
- Lobi tabanlı sistem -- kod paylaşarak davet
- Annotation oluşturma, silme, boyutlandırma ve sınıf değişikliği anlık sync
- Sınıf ekleme, silme ve yeniden adlandırma sync
- Presence sistemi -- kim hangi görselde çalışıyor gösterilir
- Aynı görselde başka biri çalışıyorsa uyarı banner'ı
- Otomatik yeniden bağlanma ve mesaj kuyruklama
- Sunucu ücretsiz olarak Render.com üzerinde çalışır -- sıfır maliyet
- Standart YOLO klasör yapısını otomatik tanır,
data.yamldosyasını (sınıflar, yollar) otomatik okur - Train / Validation / Test / Atanmamış split sistemi -- her görsele split atanabilir
- İki farklı görsel import modu:
Ekle (Add)-- mevcut split korunur, yeni görseller eklenirÜzerine Yaz (Replace)-- seçilen split temizlenir, yeni görseller yazılır
- Etiket import -- başka bir klasördeki
.txtdosyalarını dosya adı eşleştirme ile mevcut görsellere uygular - Export -- standart YOLO yapısında ve otomatik oluşturulan
data.yamlile export eder; arka planda çalışır, canlı ilerleme barı gösterir (arayüz donmaz)
dataset/
+-- train/
| +-- images/
| | +-- image1.jpg
| +-- labels/
| +-- image1.txt
+-- valid/
| +-- images/
| | +-- image2.jpg
| +-- labels/
| +-- image2.txt
+-- test/
| +-- images/
| | +-- image3.jpg
| +-- labels/
| +-- image3.txt
+-- data.yaml
Annotie bu yapıyı açılışta okur, export'ta aynı yapıda yazar -- Ultralytics YOLO ile doğrudan kullanıma hazır.
- Tıkla-bırak ile etiket çizimi -- tıkla = etiket koy, sürükle = canvas'ı kaydır
- Zoom seviyesinden bağımsız sabit boyutlu köşe tutamaçları, yalnızca hover/seçimde görünür
- Undo / Redo desteği
- Otomatik kaydetme -- her değişiklik anında
.txtdosyasına otomatik yazılır
A/D-- önceki / sonraki görsel (tüm görseller)<-/->-- yalnızca etiketli görseller arası geçiş- Sol panel, klavye navigasyonunda otomatik olarak highlight ve scroll takibi yapar
- Split sekmeleri göreli numaralandırma gösterir (Eğitim sekmesindeki 1. görsel, global indeksten bağımsızdır)
Büyük veri setlerinde çalışırken en işe yarayan özelliklerden biri:
- Konum veri seti başına, split başına (Tümü / Eğitim / Doğrulama / Test) ayrı ayrı kaydedilir
- Yalnızca "Tümü" sekmesinde gezseniz bile, her görselin hangi split'e ait olduğu bilindiğinden split bazlı konumlar da güncellenir
- Her veri seti geçişinde (kapatma, yeni açma, son açılanlar) otomatik kaydedilir
- Bir sonraki açılışta: "Eğitim kategorisinde 150. frame'de kaldınız"
- Split sekmesine tıklandığında da o kategorideki son konum gösterilir
- Koyu tema (Dark mode)
- Toast bildirimleri -- yeşil (başarı) / kırmızı (hata), animasyonlu kaybolma
- Veri seti açılışında etiketli / etiketsiz görsel sayısı,
data.yamleksikse uyarı - Son açılan veri setleri listesi, konum hafızasıyla
- Pencere durumu (boyut, panel konumları) kaydedilir ve restore edilir
- Odak Modu (
F12) -- tüm paneller gizlenir, yalnızca canvas kalır
Hazır kurulum dosyaları Releases sayfasında mevcuttur.
| Platform | Dosya | Gereksinim |
|---|---|---|
| Windows | Annotie-Windows.zip |
Windows 10/11 (64-bit) |
| macOS | Annotie-macOS.zip |
macOS 11.0+ (Intel & Apple Silicon) |
Windows: ZIP'i çıkart, Annotie.exe dosyasını çalıştır.
macOS: ZIP'i çıkart, Annotie.app dosyasını Uygulamalar klasörüne taşı.
Annotie ücretli bir Apple/Microsoft geliştirici sertifikasıyla imzalanmamıştır. Bu nedenle ilk açılışta her iki platformda da güvenlik uyarısı görebilirsiniz. Bu tamamen normaldir; uygulama zararlı değildir, kaynak kodunun tamamı bu repoda açık olarak mevcuttur.
Yöntem 1 -- Sağ tık ile aç (En kolay):
Annotie.appdosyasına sağ tıkla- "Aç" seç
- Çıkan uyarıda "Aç" butonuna bas -- bu adımdan sonra bir daha sormaz
Yöntem 2 -- Sistem Ayarları:
- Uygulamayı bir kez çift tıkla (uyarı çıkacak, kapat)
- Sistem Ayarları - Gizlilik ve Güvenlik bölümüne git
- En alta in - "Yine de Aç" butonuna tıkla
Yontem 3 -- Terminal:
sudo xattr -rd com.apple.quarantine /Applications/Annotie.app- "Daha fazla bilgi" bağlantısına tıkla
- "Yine de çalıştır" butonuna bas
git clone https://github.com/EnesSoydan/Annotie.git
cd Annotie
pip install -r requirements.txt
python main.pyGereksinimler: Python 3.10+
PySide6>=6.6.0
Pillow>=10.0.0
PyYAML>=6.0
numpy>=1.24.0
Windows için ücretsiz kod imzalama hizmeti SignPath.io tarafından sağlanmakta olup sertifika SignPath Foundation tarafından verilmektedir.
| Rol | Kişi |
|---|---|
| Geliştirici & Onaylayıcı | EnesSoydan |
Bu uygulama, kullanıcı tarafından açıkça talep edilmedikçe herhangi bir bilgiyi harici sistemlere iletmez.
GPL-3.0 Lisansı -- ücretsiz kullanım ve değiştirme serbesttir; türetilmiş çalışmalar da aynı lisansla açık kaynak olarak dağıtılmalıdır.
Annotie is a desktop image annotation application built for creating and managing YOLO-format datasets. It supports all major YOLO task types in a single tool -- no subscriptions, no limits, no cloud uploads.
| Type | YOLO Task |
|---|---|
| Bounding Box (BBox) | Detection |
| Polygon | Segmentation |
| Oriented Bounding Box (OBB) | OBB Detection |
| Keypoints | Pose Estimation |
| Classification | Image Classification |
Mixed annotations are supported -- different label types can coexist in the same dataset. Compatible with all YOLO versions (v5, v8, v10, v11, v12+).
Annotie allows multiple people to work on the same dataset simultaneously -- whether in the same room or across different locations worldwide.
How It Works:
- One user clicks Create Lobby and a 6-digit code is generated
- Others join the lobby by entering the code
- All annotation changes (create, delete, move, class change) sync instantly
Features:
- Lobby-based system -- invite by sharing a code
- Instant sync for annotation creation, deletion, resizing, and class changes
- Class addition, deletion, and renaming sync
- Presence system -- see who is working on which image
- Warning banner when someone else is editing the same image
- Automatic reconnection and message queuing
- Server runs free on Render.com -- zero cost
- Auto-detects standard YOLO folder structure and reads
data.yaml(classes, paths) automatically - Train / Validation / Test / Unassigned split system -- assign any image to any split
- Two import modes for images:
Add-- append new images while keeping existing onesReplace-- clear the selected split and write fresh
- Label import -- apply
.txtannotation files from any folder by matching filenames - Export -- produces the standard YOLO structure with an auto-generated
data.yaml, runs in the background with a live progress bar (UI never freezes)
dataset/
+-- train/
| +-- images/
| | +-- image1.jpg
| +-- labels/
| +-- image1.txt
+-- valid/
| +-- images/
| | +-- image2.jpg
| +-- labels/
| +-- image2.txt
+-- test/
| +-- images/
| | +-- image3.jpg
| +-- labels/
| +-- image3.txt
+-- data.yaml
Annotie reads this structure on open and writes it back on export -- ready to use directly with Ultralytics YOLO.
- Click to annotate -- click to place points/boxes, drag to pan the canvas
- Fixed-size corner handles independent of zoom level, visible only on hover/select
- Undo / Redo support
- Auto-save -- changes are written to
.txtfiles instantly
A/D-- previous / next image (all images)<-/->-- previous / next labeled image only- Image list panel auto-scrolls and highlights current image on keyboard navigation
- Split tabs show relative numbering (e.g. image #1 in the Val tab is independent of its global index)
One of the most useful features for large datasets:
- Saves your position per dataset, per split (All / Train / Val / Test)
- Even if you only browse in the All tab, per-split positions are tracked since each image's split is already known
- Position is saved on every dataset switch -- not just on app close
- On next open: "You left off at frame 150 in the Training split"
- Clicking a split tab also shows where you left off in that split
- Dark theme
- Toast notifications -- green (success) / red (error) with fade-out animation
- On dataset open: shows labeled vs. unlabeled image count, warns if
data.yamlis missing - Recent files list with position memory per dataset
- Window state (size, panel positions) saved and restored
- Focus Mode (
F12) -- hides all panels, only the canvas remains
Pre-built binaries are available on the Releases page.
| Platform | File | Requirements |
|---|---|---|
| Windows | Annotie-Windows.zip |
Windows 10/11 (64-bit) |
| macOS | Annotie-macOS.zip |
macOS 11.0+ (Intel & Apple Silicon) |
Windows: Extract the ZIP and run Annotie.exe
macOS: Extract the ZIP, move Annotie.app to Applications.
Annotie is not signed with a paid Apple/Microsoft developer certificate. Because of this, both platforms may show a security warning on first launch. This is completely normal -- the app is safe, and the full source code is publicly available in this repository.
Method 1 -- Right-click to open (Easiest):
- Right-click
Annotie.app - Select "Open"
- Click "Open" in the dialog -- it won't ask again after this
Method 2 -- System Settings:
- Double-click the app once (warning will appear, close it)
- Go to System Settings - Privacy & Security
- Scroll down - click "Open Anyway"
Method 3 -- Terminal:
sudo xattr -rd com.apple.quarantine /Applications/Annotie.app- Click "More info"
- Click "Run anyway"
git clone https://github.com/EnesSoydan/Annotie.git
cd Annotie
pip install -r requirements.txt
python main.pyRequirements: Python 3.10+
PySide6>=6.6.0
Pillow>=10.0.0
PyYAML>=6.0
numpy>=1.24.0
Free code signing provided by SignPath.io, certificate by SignPath Foundation.
| Role | Member |
|---|---|
| Developer & Approver | EnesSoydan |
This program will not transfer any information to other networked systems unless specifically requested by the user.
GPL-3.0 License -- free to use and modify; derivative works must be distributed under the same license as open source.

