cvflair 0.2.0__tar.gz

cvflair-0.2.0/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Değişiklik günlüğü
+
+Sürümleme [Semantic Versioning](https://semver.org/lang/tr/) izler.
+Paket henüz PyPI'da yayınlanmadı; sürümler depo içi kilometre taşlarıdır.
+
+## 0.2.0
+
+### Eklendi
+- `Camera.stream(model=...)`: model verildiğinde akış `(kare, tespitler)` çifti üretir.
+- `cvflair.models`: ağırlık yolu, hazır Ultralytics modeli veya `sv.Detections`
+  döndüren herhangi bir çağrılabilir aynı detektör arayüzüne çevriliyor.
+- `UltralyticsDetector` — `conf`, `iou`, `device` gibi ayarları her çağrıya taşır,
+  `verbose` varsayılan olarak kapalı.
+- `yolo` extra'sı (`pip install "cvflair[yolo]"`). Ultralytics AGPL-3.0 olduğu için
+  zorunlu bağımlılık değil; eksikse hata mesajı extra'yı ve lisans gerekçesini söylüyor.
+- `examples/yolo_quickstart.py`.
+
+## 0.1.0
+
+### Eklendi
+- `Camera`: webcam açma, ayrı thread'de okuma, son kareyi tutan tek slotlu kuyruk,
+  `q`/ESC ile biten `stream()` akışı.
+- `Theme`: `supervision` annotator'larını yapılandıran katman; `minimal`, `neon`,
+  `pastel` temaları. Annotator'lar tema kurulurken bir kez oluşturuluyor.
+- Türkçe README, `docs/demo.gif` üreten `tools/make_demo_gif.py`, kamerasız örnekler.
+- Kamera gerektirmeyen pytest paketi (sahte `capture_factory`).

cvflair-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kbycode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cvflair-0.2.0/MANIFEST.in

@@ -0,0 +1,12 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+
+# Testler sdist'ten de çalışabilsin: conftest.py olmadan test dosyaları import edilemiyor.
+recursive-include tests *.py
+recursive-include examples *.py
+recursive-include tools *.py
+
+# Dokümantasyon görselleri depoda duruyor, pakete girmiyor (README mutlak URL kullanıyor).
+prune docs
+prune .github

cvflair-0.2.0/PKG-INFO

@@ -0,0 +1,249 @@
+Metadata-Version: 2.4
+Name: cvflair
+Version: 0.2.0
+Summary: Theme-based, model-agnostic visualisation layer for computer vision detections, built on supervision.
+Author: kbycode
+License: MIT
+Project-URL: Homepage, https://github.com/kbycode/cvflair
+Project-URL: Documentation, https://github.com/kbycode/cvflair#readme
+Project-URL: Repository, https://github.com/kbycode/cvflair
+Project-URL: Issues, https://github.com/kbycode/cvflair/issues
+Project-URL: Changelog, https://github.com/kbycode/cvflair/blob/main/CHANGELOG.md
+Keywords: computer-vision,opencv,supervision,annotation,visualization,webcam,yolo,bounding-box,themes
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Classifier: Topic :: Multimedia :: Video :: Display
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: opencv-python>=4.8
+Requires-Dist: supervision<0.30,>=0.28
+Provides-Extra: yolo
+Requires-Dist: ultralytics>=8.2; extra == "yolo"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: pillow>=10.0; extra == "dev"
+Provides-Extra: release
+Requires-Dist: build>=1.2; extra == "release"
+Requires-Dist: twine>=5.0; extra == "release"
+Dynamic: license-file
+
+# cvflair
+
+Bilgisayarlı görü tespitlerini üç satırda, hazır temalarla ekrana çizen ince bir katman.
+
+Çizim işini [supervision](https://github.com/roboflow/supervision) yapar; cvflair kamera
+döngüsünü ve tema ayarlarını üstlenir. Model bağımsızdır: `supervision`'ın `Detections`
+nesnesini üreten her kaynak (YOLO, MediaPipe, InsightFace veya özel bir model) tema
+tarafından çizilebilir.
+
+![cvflair demo](https://raw.githubusercontent.com/kbycode/cvflair/main/docs/demo.gif)
+
+*Aynı tespitler, üç tema. Animasyon `tools/make_demo_gif.py` ile üretildi — sentetik
+sahne, kamera gerekmiyor.*
+
+> **Durum:** Faz 1 tamam (kamera döngüsü, üç tema, testler), Faz 2 başladı (model
+> bağlama). Paket henüz PyPI'da yayınlanmadı.
+
+## Kurulum
+
+Python 3.10 veya üzeri gerekir (bu alt sınır `supervision`'dan geliyor).
+
+```bash
+git clone https://github.com/kbycode/cvflair.git
+cd cvflair
+pip install -e .
+```
+
+Yayınlandıktan sonra: `pip install cvflair`
+
+YOLO ile kullanmak için Ultralytics extra'sı: `pip install -e ".[yolo]"`
+(ayrıntı ve lisans notu için aşağıdaki [Lisans](#lisans) bölümü).
+
+## Hızlı başlangıç
+
+```python
+from cvflair import Camera
+
+cam = Camera(source=0, theme="neon")
+for frame in cam.stream():
+    cam.show(frame)
+```
+
+Kamera açılır, kareler ayrı bir thread'de okunur, pencere `q` veya ESC ile kapanır —
+`release()` çağırmaya, `while True` kurmaya gerek yok.
+
+> Model verilmeyen bu akışta ekranda ham kare görünür: tema ancak ortada tespit
+> varken çizim yapar. Temayı modelsiz, canlı görmek için:
+> `python examples/demo_fake_detections.py` — kamera görüntüsü üzerine hareketli sahte
+> kutular çizer ve temaları 3 saniyede bir değiştirir.
+
+## Modelle kullanım
+
+`stream()`'e bir model verildiğinde her adım `(kare, tespitler)` çifti döndürür ve
+tema otomatik uygulanır:
+
+```python
+from cvflair import Camera
+
+cam = Camera(source=0, theme="neon")
+for frame, detections in cam.stream(model="yolov8n.pt"):
+    cam.show(frame, detections)
+```
+
+`model` üç şeyden biri olabilir:
+
+| Değer | Anlamı |
+|---|---|
+| `"yolov8n.pt"` (ağırlık yolu) | Ultralytics ile yüklenir — `cvflair[yolo]` gerekir |
+| Hazır bir Ultralytics modeli | `YOLO(...)` nesnesi doğrudan verilebilir, çıktısı dönüştürülür |
+| Herhangi bir çağrılabilir | `sv.Detections` döndüren kendi fonksiyonun — MediaPipe, InsightFace, özel model |
+
+Son seçenek kütüphaneyi model-agnostik yapan yer:
+
+```python
+import supervision as sv
+from cvflair import Camera
+
+def detect(frame) -> sv.Detections:
+    ...  # kendi modelin
+    return sv.Detections(xyxy=..., class_id=..., confidence=...)
+
+cam = Camera(source=0, theme="pastel")
+for frame, detections in cam.stream(model=detect):
+    cam.show(frame, detections)
+```
+
+Çıkarım bu döngüde çalışır, okuma thread'inde değil: bir kare işlenirken okuyucu
+kuyruktaki kareyi tazelemeye devam eder, dolayısıyla bir sonraki tur birikmiş
+kareyle değil en güncel kareyle başlar.
+
+Ultralytics'e ek ayar geçirmek için `UltralyticsDetector` doğrudan kullanılabilir:
+
+```python
+from cvflair import Camera, UltralyticsDetector
+from ultralytics import YOLO
+
+detector = UltralyticsDetector(YOLO("yolov8n.pt"), conf=0.4, device="cpu", classes=[0])
+cam = Camera(source=0, theme="neon")
+for frame, detections in cam.stream(model=detector):
+    cam.show(frame, detections)
+```
+
+Etiket metni doğrudan da verilebilir: `cam.show(frame, detections, labels=[...])`.
+Pencere yönetimi uygulamaya aitse `cam.annotate(frame, detections)` yalnızca çizim yapar.
+
+## Temalar
+
+| Tema | Görünüm | |
+|---|---|---|
+| `minimal` | ince beyaz çerçeve, sade etiket — ekran kaydı ve profesyonel demo için | ![minimal](https://raw.githubusercontent.com/kbycode/cvflair/main/docs/theme-minimal.png) |
+| `neon` | sınıf başına canlı renk, yuvarlak köşe, koyu hâle ile parlama hissi | ![neon](https://raw.githubusercontent.com/kbycode/cvflair/main/docs/theme-neon.png) |
+| `pastel` | yumuşak tonlar, geniş yuvarlama, koyu etiket yazısı — atölye/projeksiyon | ![pastel](https://raw.githubusercontent.com/kbycode/cvflair/main/docs/theme-pastel.png) |
+
+Yol haritasındaki `cyberpunk` ve `hud` temaları Faz 2'de gelecek.
+
+Özel bir tema, `Theme` doğrudan kurulup `Camera`'ya verilerek tanımlanır:
+
+```python
+import supervision as sv
+from cvflair import Camera, Theme
+
+my_theme = Theme(
+    name="my-theme",
+    palette=sv.ColorPalette.from_hex(["#39FF14", "#FF00E5"]),
+    box_style="corner",     # "box" | "round" | "corner"
+    thickness=2,
+    glow=True,
+    text_scale=0.6,
+)
+cam = Camera(source=0, theme=my_theme)
+```
+
+Temaları görmenin iki yolu:
+
+```bash
+python examples/demo_fake_detections.py   # canlı kamera + hareketli sahte tespitler
+python examples/theme_preview.py          # kamerasız, her temayı bir PNG'ye çizer
+```
+
+## API özeti
+
+| Üye | Ne yapar |
+|---|---|
+| `Camera(source, theme, width, height, fps, window_name, capture_factory)` | Kaynağı ve temayı bağlar; kamerayı henüz açmaz |
+| `cam.start()` / `cam.close()` | Cihazı açar ve okuma thread'ini başlatır / her şeyi bırakır |
+| `cam.stream(timeout, model=None)` | Kareleri üretir; model verilirse `(kare, tespitler)` çifti. İlk kullanımda `start()`, bitince `close()` eder |
+| `cam.read(timeout)` | En güncel tek kareyi döndürür, kaynak bittiyse `None` |
+| `cam.show(frame, detections, labels)` | Temayı uygular, pencerede gösterir; çıkış istendiğinde `False` döner |
+| `cam.annotate(frame, detections, labels)` | Sadece çizer, pencere açmaz |
+| `cam.theme` | Okunur/yazılır; `cam.theme = "minimal"` çalışır |
+| `cam.frames_read` / `cam.frames_dropped` | Okunan ve tüketici yetişemediği için atılan kare sayısı |
+| `get_theme(ad)` / `available_themes()` | Tema adını çözer / mevcut adları listeler |
+| `UltralyticsDetector(model, **kwargs)` | Ultralytics çıktısını `sv.Detections`'a çevirir; `conf`, `iou`, `device` gibi ayarları taşır |
+| `resolve_detector(model)` | Ağırlık yolu / model / çağrılabilir → detektör; `stream()` bunu kullanır |
+
+`Camera` bağlam yöneticisi olarak da kullanılabilir: `with Camera() as cam: ...`
+
+## Nasıl çalışıyor
+
+- **Kareler ayrı thread'de okunur.** Okuyucu, tüketiciyi beklemez.
+- **Kuyruk tek slotlu.** Yeni kare gelince bekleyen eski kare düşürülür
+  (`frames_dropped` ile sayılır). Böylece işleme yavaşladığında gecikme birikmez;
+  ekranda hep en güncel kare olur.
+- **Annotator'lar bir kere kurulur.** `Theme` nesnesi oluşturulurken `supervision`
+  annotator'ları hazırlanır ve her karede yeniden kullanılır — döngü içinde annotator
+  kurmak bu tür işlerde en sık görülen gereksiz maliyettir.
+- **Çizim matematiği yeniden yazılmadı.** Her piksel `supervision` tarafından çiziliyor;
+  cvflair sadece yapılandırma ve akış katmanı.
+- **Model paketin dışında.** `stream(model=...)` verilen şeyi bir çağrılabilire çevirir;
+  ağırlıklar ilk yinelemede yüklenir. Hiçbir model kodu veya ağırlığı pakete gömülü değil.
+
+## Geliştirme
+
+```bash
+python -m venv .venv
+.venv\Scripts\activate
+pip install -e ".[dev]"
+pytest
+ruff check .
+```
+
+Testler kamera gerektirmez: `Camera`'ya `capture_factory` üzerinden sahte bir
+`VideoCapture` verilir, temalar da sentetik kareler üzerinde doğrulanır.
+
+Dokümantasyon görselleri de kamerasız üretilir:
+
+```bash
+python tools/make_demo_gif.py    # docs/demo.gif
+python examples/theme_preview.py # examples/output/theme-*.png
+```
+
+## Yol haritası
+
+| Faz | İçerik | Durum |
+|---|---|---|
+| Faz 1 | Kamera döngüsü, `minimal`/`neon`/`pastel` temaları, README, demo GIF, testler | tamam |
+| Faz 2 | Model bağlama (`stream(model=...)`) | tamam |
+| Faz 2 | PyPI paketi, Türkçe dokümantasyon sitesi, tema playground, `cyberpunk`/`hud` | sırada |
+| Faz 3 | GitHub Actions (lint + test), issue şablonları, örnek galerisi | planlandı |
+
+## Lisans
+
+MIT — bkz. [LICENSE](LICENSE). Bağımlılıkların hepsi izin verici lisanslı
+(`supervision` MIT, `opencv-python` Apache 2.0, `numpy` BSD).
+
+YOLO ağırlıkları veya Ultralytics kodu bu pakete gömülü değildir; Ultralytics'in
+kullanılması hâlinde AGPL-3.0 koşulları onu kullanan projenin sorumluluğundadır.

cvflair-0.2.0/README.md

@@ -0,0 +1,207 @@
+# cvflair
+
+Bilgisayarlı görü tespitlerini üç satırda, hazır temalarla ekrana çizen ince bir katman.
+
+Çizim işini [supervision](https://github.com/roboflow/supervision) yapar; cvflair kamera
+döngüsünü ve tema ayarlarını üstlenir. Model bağımsızdır: `supervision`'ın `Detections`
+nesnesini üreten her kaynak (YOLO, MediaPipe, InsightFace veya özel bir model) tema
+tarafından çizilebilir.
+
+![cvflair demo](https://raw.githubusercontent.com/kbycode/cvflair/main/docs/demo.gif)
+
+*Aynı tespitler, üç tema. Animasyon `tools/make_demo_gif.py` ile üretildi — sentetik
+sahne, kamera gerekmiyor.*
+
+> **Durum:** Faz 1 tamam (kamera döngüsü, üç tema, testler), Faz 2 başladı (model
+> bağlama). Paket henüz PyPI'da yayınlanmadı.
+
+## Kurulum
+
+Python 3.10 veya üzeri gerekir (bu alt sınır `supervision`'dan geliyor).
+
+```bash
+git clone https://github.com/kbycode/cvflair.git
+cd cvflair
+pip install -e .
+```
+
+Yayınlandıktan sonra: `pip install cvflair`
+
+YOLO ile kullanmak için Ultralytics extra'sı: `pip install -e ".[yolo]"`
+(ayrıntı ve lisans notu için aşağıdaki [Lisans](#lisans) bölümü).
+
+## Hızlı başlangıç
+
+```python
+from cvflair import Camera
+
+cam = Camera(source=0, theme="neon")
+for frame in cam.stream():
+    cam.show(frame)
+```
+
+Kamera açılır, kareler ayrı bir thread'de okunur, pencere `q` veya ESC ile kapanır —
+`release()` çağırmaya, `while True` kurmaya gerek yok.
+
+> Model verilmeyen bu akışta ekranda ham kare görünür: tema ancak ortada tespit
+> varken çizim yapar. Temayı modelsiz, canlı görmek için:
+> `python examples/demo_fake_detections.py` — kamera görüntüsü üzerine hareketli sahte
+> kutular çizer ve temaları 3 saniyede bir değiştirir.
+
+## Modelle kullanım
+
+`stream()`'e bir model verildiğinde her adım `(kare, tespitler)` çifti döndürür ve
+tema otomatik uygulanır:
+
+```python
+from cvflair import Camera
+
+cam = Camera(source=0, theme="neon")
+for frame, detections in cam.stream(model="yolov8n.pt"):
+    cam.show(frame, detections)
+```
+
+`model` üç şeyden biri olabilir:
+
+| Değer | Anlamı |
+|---|---|
+| `"yolov8n.pt"` (ağırlık yolu) | Ultralytics ile yüklenir — `cvflair[yolo]` gerekir |
+| Hazır bir Ultralytics modeli | `YOLO(...)` nesnesi doğrudan verilebilir, çıktısı dönüştürülür |
+| Herhangi bir çağrılabilir | `sv.Detections` döndüren kendi fonksiyonun — MediaPipe, InsightFace, özel model |
+
+Son seçenek kütüphaneyi model-agnostik yapan yer:
+
+```python
+import supervision as sv
+from cvflair import Camera
+
+def detect(frame) -> sv.Detections:
+    ...  # kendi modelin
+    return sv.Detections(xyxy=..., class_id=..., confidence=...)
+
+cam = Camera(source=0, theme="pastel")
+for frame, detections in cam.stream(model=detect):
+    cam.show(frame, detections)
+```
+
+Çıkarım bu döngüde çalışır, okuma thread'inde değil: bir kare işlenirken okuyucu
+kuyruktaki kareyi tazelemeye devam eder, dolayısıyla bir sonraki tur birikmiş
+kareyle değil en güncel kareyle başlar.
+
+Ultralytics'e ek ayar geçirmek için `UltralyticsDetector` doğrudan kullanılabilir:
+
+```python
+from cvflair import Camera, UltralyticsDetector
+from ultralytics import YOLO
+
+detector = UltralyticsDetector(YOLO("yolov8n.pt"), conf=0.4, device="cpu", classes=[0])
+cam = Camera(source=0, theme="neon")
+for frame, detections in cam.stream(model=detector):
+    cam.show(frame, detections)
+```
+
+Etiket metni doğrudan da verilebilir: `cam.show(frame, detections, labels=[...])`.
+Pencere yönetimi uygulamaya aitse `cam.annotate(frame, detections)` yalnızca çizim yapar.
+
+## Temalar
+
+| Tema | Görünüm | |
+|---|---|---|
+| `minimal` | ince beyaz çerçeve, sade etiket — ekran kaydı ve profesyonel demo için | ![minimal](https://raw.githubusercontent.com/kbycode/cvflair/main/docs/theme-minimal.png) |
+| `neon` | sınıf başına canlı renk, yuvarlak köşe, koyu hâle ile parlama hissi | ![neon](https://raw.githubusercontent.com/kbycode/cvflair/main/docs/theme-neon.png) |
+| `pastel` | yumuşak tonlar, geniş yuvarlama, koyu etiket yazısı — atölye/projeksiyon | ![pastel](https://raw.githubusercontent.com/kbycode/cvflair/main/docs/theme-pastel.png) |
+
+Yol haritasındaki `cyberpunk` ve `hud` temaları Faz 2'de gelecek.
+
+Özel bir tema, `Theme` doğrudan kurulup `Camera`'ya verilerek tanımlanır:
+
+```python
+import supervision as sv
+from cvflair import Camera, Theme
+
+my_theme = Theme(
+    name="my-theme",
+    palette=sv.ColorPalette.from_hex(["#39FF14", "#FF00E5"]),
+    box_style="corner",     # "box" | "round" | "corner"
+    thickness=2,
+    glow=True,
+    text_scale=0.6,
+)
+cam = Camera(source=0, theme=my_theme)
+```
+
+Temaları görmenin iki yolu:
+
+```bash
+python examples/demo_fake_detections.py   # canlı kamera + hareketli sahte tespitler
+python examples/theme_preview.py          # kamerasız, her temayı bir PNG'ye çizer
+```
+
+## API özeti
+
+| Üye | Ne yapar |
+|---|---|
+| `Camera(source, theme, width, height, fps, window_name, capture_factory)` | Kaynağı ve temayı bağlar; kamerayı henüz açmaz |
+| `cam.start()` / `cam.close()` | Cihazı açar ve okuma thread'ini başlatır / her şeyi bırakır |
+| `cam.stream(timeout, model=None)` | Kareleri üretir; model verilirse `(kare, tespitler)` çifti. İlk kullanımda `start()`, bitince `close()` eder |
+| `cam.read(timeout)` | En güncel tek kareyi döndürür, kaynak bittiyse `None` |
+| `cam.show(frame, detections, labels)` | Temayı uygular, pencerede gösterir; çıkış istendiğinde `False` döner |
+| `cam.annotate(frame, detections, labels)` | Sadece çizer, pencere açmaz |
+| `cam.theme` | Okunur/yazılır; `cam.theme = "minimal"` çalışır |
+| `cam.frames_read` / `cam.frames_dropped` | Okunan ve tüketici yetişemediği için atılan kare sayısı |
+| `get_theme(ad)` / `available_themes()` | Tema adını çözer / mevcut adları listeler |
+| `UltralyticsDetector(model, **kwargs)` | Ultralytics çıktısını `sv.Detections`'a çevirir; `conf`, `iou`, `device` gibi ayarları taşır |
+| `resolve_detector(model)` | Ağırlık yolu / model / çağrılabilir → detektör; `stream()` bunu kullanır |
+
+`Camera` bağlam yöneticisi olarak da kullanılabilir: `with Camera() as cam: ...`
+
+## Nasıl çalışıyor
+
+- **Kareler ayrı thread'de okunur.** Okuyucu, tüketiciyi beklemez.
+- **Kuyruk tek slotlu.** Yeni kare gelince bekleyen eski kare düşürülür
+  (`frames_dropped` ile sayılır). Böylece işleme yavaşladığında gecikme birikmez;
+  ekranda hep en güncel kare olur.
+- **Annotator'lar bir kere kurulur.** `Theme` nesnesi oluşturulurken `supervision`
+  annotator'ları hazırlanır ve her karede yeniden kullanılır — döngü içinde annotator
+  kurmak bu tür işlerde en sık görülen gereksiz maliyettir.
+- **Çizim matematiği yeniden yazılmadı.** Her piksel `supervision` tarafından çiziliyor;
+  cvflair sadece yapılandırma ve akış katmanı.
+- **Model paketin dışında.** `stream(model=...)` verilen şeyi bir çağrılabilire çevirir;
+  ağırlıklar ilk yinelemede yüklenir. Hiçbir model kodu veya ağırlığı pakete gömülü değil.
+
+## Geliştirme
+
+```bash
+python -m venv .venv
+.venv\Scripts\activate
+pip install -e ".[dev]"
+pytest
+ruff check .
+```
+
+Testler kamera gerektirmez: `Camera`'ya `capture_factory` üzerinden sahte bir
+`VideoCapture` verilir, temalar da sentetik kareler üzerinde doğrulanır.
+
+Dokümantasyon görselleri de kamerasız üretilir:
+
+```bash
+python tools/make_demo_gif.py    # docs/demo.gif
+python examples/theme_preview.py # examples/output/theme-*.png
+```
+
+## Yol haritası
+
+| Faz | İçerik | Durum |
+|---|---|---|
+| Faz 1 | Kamera döngüsü, `minimal`/`neon`/`pastel` temaları, README, demo GIF, testler | tamam |
+| Faz 2 | Model bağlama (`stream(model=...)`) | tamam |
+| Faz 2 | PyPI paketi, Türkçe dokümantasyon sitesi, tema playground, `cyberpunk`/`hud` | sırada |
+| Faz 3 | GitHub Actions (lint + test), issue şablonları, örnek galerisi | planlandı |
+
+## Lisans
+
+MIT — bkz. [LICENSE](LICENSE). Bağımlılıkların hepsi izin verici lisanslı
+(`supervision` MIT, `opencv-python` Apache 2.0, `numpy` BSD).
+
+YOLO ağırlıkları veya Ultralytics kodu bu pakete gömülü değildir; Ultralytics'in
+kullanılması hâlinde AGPL-3.0 koşulları onu kullanan projenin sorumluluğundadır.

cvflair-0.2.0/examples/demo_fake_detections.py

@@ -0,0 +1,80 @@
+"""
+Modelsiz canlı demo: kamera görüntüsü üzerine hareketli sahte tespitler çizer.
+
+Faz 1'de model bağlama yok; bu betik tespitlerin yerine hareket eden kutular
+üreterek temayı canlı gösterir. Temalar birkaç saniyede bir sırayla değişir.
+
+Çalıştırmak için:  python examples/demo_fake_detections.py
+Çıkmak için:      pencere seçiliyken 'q' veya ESC
+"""
+
+import math
+import time
+
+import numpy as np
+import supervision as sv
+
+from cvflair import Camera, available_themes
+
+#: Kaç saniyede bir sıradaki temaya geçileceği. Kare sayısı yerine süre
+#: kullanılıyor, çünkü kare hızı cihaza göre değişiyor.
+THEME_SWITCH_SECONDS = 3.0
+
+CLASS_NAMES = ("kutu", "hedef")
+
+
+def _pulse(tick: int, period: int, low: float, high: float) -> float:
+    """(low, high) aralığında ileri geri salınan bir değer."""
+    phase = (math.sin(2 * math.pi * tick / period) + 1) / 2
+    return low + (high - low) * phase
+
+
+def fake_detections(width: int, height: int, tick: int) -> sv.Detections:
+    """İki kutu: biri yatay, diğeri dikey salınıyor."""
+    box_w, box_h = width * 0.26, height * 0.42
+    left = _pulse(tick, 140, 0.04, 0.42) * width
+    top = height * 0.18
+
+    small_w, small_h = width * 0.20, height * 0.28
+    small_left = width * 0.62
+    small_top = _pulse(tick, 100, 0.10, 0.55) * height
+
+    return sv.Detections(
+        xyxy=np.array(
+            [
+                [left, top, left + box_w, top + box_h],
+                [small_left, small_top, small_left + small_w, small_top + small_h],
+            ],
+            dtype=np.float32,
+        ),
+        class_id=np.array([0, 1]),
+        confidence=np.array(
+            [_pulse(tick, 70, 0.55, 0.99), _pulse(tick, 55, 0.40, 0.95)], dtype=np.float32
+        ),
+    )
+
+
+def main() -> None:
+    themes = available_themes()
+    print(f"Temalar sırayla: {', '.join(themes)} — çıkmak için 'q' veya ESC")
+
+    cam = Camera(source=0, theme=themes[0])
+    started = time.monotonic()
+    for tick, frame in enumerate(cam.stream()):
+        elapsed = time.monotonic() - started
+        wanted = themes[int(elapsed // THEME_SWITCH_SECONDS) % len(themes)]
+        if wanted != cam.theme.name:
+            # Tema atamak annotator'ları yeniden kurar; sadece ad değişince yapılıyor.
+            cam.theme = wanted
+
+        height, width = frame.shape[:2]
+        detections = fake_detections(width, height, tick)
+        labels = [
+            f"{name} {confidence:.2f}"
+            for name, confidence in zip(CLASS_NAMES, detections.confidence, strict=True)
+        ]
+        cam.show(frame, detections, labels=labels)
+
+
+if __name__ == "__main__":
+    main()

cvflair-0.2.0/examples/quickstart.py

@@ -0,0 +1,16 @@
+"""
+Üç satırlık başlangıç: kamerayı aç, kareleri neon temasıyla göster.
+
+Tespit verilmediği için ekranda ham kare görünür — tema yalnızca `show()`'a bir
+`Detections` geldiğinde çizim yapar. Temayı modelsiz görmek için:
+examples/demo_fake_detections.py
+
+Çalıştırmak için:  python examples/quickstart.py
+Çıkmak için:      pencere seçiliyken 'q' veya ESC
+"""
+
+from cvflair import Camera
+
+cam = Camera(source=0, theme="neon")
+for frame in cam.stream():
+    cam.show(frame)

cvflair-0.2.0/examples/theme_preview.py

@@ -0,0 +1,45 @@
+"""
+Kamerasız tema önizlemesi: sahte tespitlerle her temayı bir PNG'ye çizer.
+
+Çalıştırmak için:  python examples/theme_preview.py
+Çıktı:             examples/output/theme-<ad>.png
+"""
+
+from pathlib import Path
+
+import cv2
+import numpy as np
+import supervision as sv
+
+from cvflair import available_themes, get_theme
+
+OUTPUT_DIR = Path(__file__).parent / "output"
+
+# Tespit üreten bir model yerine sabit kutular: amaç temanın görünümü.
+DETECTIONS = sv.Detections(
+    xyxy=np.array(
+        [[60, 90, 300, 380], [340, 140, 560, 330], [600, 60, 760, 260]], dtype=np.float32
+    ),
+    class_id=np.array([0, 1, 2]),
+    confidence=np.array([0.94, 0.81, 0.66], dtype=np.float32),
+)
+LABELS = ["kisi 0.94", "bisiklet 0.81", "kopek 0.66"]
+
+
+def backdrop(width: int = 840, height: int = 460) -> np.ndarray:
+    """Koyu gri, hafif degradeli bir zemin — kutuların kontrastını görmek için."""
+    column = np.linspace(28, 58, width, dtype=np.uint8)
+    return np.repeat(column[None, :, None], height, axis=0).repeat(3, axis=2)
+
+
+def main() -> None:
+    OUTPUT_DIR.mkdir(exist_ok=True)
+    for name in available_themes():
+        frame = get_theme(name).annotate(backdrop(), DETECTIONS, labels=LABELS)
+        path = OUTPUT_DIR / f"theme-{name}.png"
+        cv2.imwrite(str(path), frame)
+        print(f"{name:>8} -> {path}")
+
+
+if __name__ == "__main__":
+    main()

cvflair-0.2.0/examples/yolo_quickstart.py

@@ -0,0 +1,21 @@
+"""
+YOLO ile üç satırlık akış.
+
+Gereken: pip install "cvflair[yolo]"
+Ağırlık dosyası ilk çalıştırmada Ultralytics tarafından indirilir.
+Ultralytics AGPL-3.0 lisanslıdır; cvflair'in zorunlu bağımlılığı değildir.
+
+Etiketler sınıf adlarından gelir (supervision dönüşümü class_name alanını doldurur).
+Güven skorunu da yazdırmak için:
+    labels = [f"{n} {c:.2f}" for n, c in zip(detections["class_name"], detections.confidence)]
+    cam.show(frame, detections, labels=labels)
+
+Çalıştırmak için:  python examples/yolo_quickstart.py
+Çıkmak için:      pencere seçiliyken 'q' veya ESC
+"""
+
+from cvflair import Camera
+
+cam = Camera(source=0, theme="neon")
+for frame, detections in cam.stream(model="yolov8n.pt"):
+    cam.show(frame, detections)