Metadata-Version: 2.4
Name: biyoves
Version: 1.0.1
Summary: Yapay Zeka destekli Biyometrik, Vesikalık ve Vize fotoğrafları oluşturma kütüphanesi.
Author: BiyoVes
License: MIT
Project-URL: Homepage, https://github.com/aytugyuruk/biyoves
Project-URL: Documentation, https://github.com/aytugyuruk/biyoves#readme
Project-URL: Repository, https://github.com/aytugyuruk/biyoves
Keywords: biyometrik,fotoğraf,vesikalık,vize,yapay zeka
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia :: Graphics :: Capture :: Digital Camera
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opencv-python-headless>=4.5.0
Requires-Dist: numpy>=1.19.0
Requires-Dist: onnxruntime>=1.10.0
Dynamic: license-file

# BiyoVes - Python Library

Yapay Zeka destekli Biyometrik, Vesikalık ve Vize fotoğrafları oluşturma kütüphanesi.

## Kurulum

```bash
pip install biyoves
```

Veya kaynak koddan:

```bash
git clone https://github.com/aytugyuruk/biyoves.git
cd biyoves
pip install -e .
```

## Hızlı Başlangıç

### Yöntem 1: Sınıf Kullanımı (Önerilen)

```python
from biyoves import BiyoVes

# Fotoğraf yolunu belirt
img = BiyoVes("foto.jpg")

# Vesikalık fotoğraf oluştur (2li layout)
vesikalik = img.create_image("vesikalik", "2li", "sonuc_vesikalik.jpg")

# Biyometrik fotoğraf oluştur (4lu layout)
biyometrik = img.create_image("biyometrik", "4lu", "sonuc_biyometrik.jpg")

# ABD vizesi için
abd_vizesi = img.create_image("abd_vizesi", "2li", "sonuc_abd.jpg")

# Schengen vizesi için
schengen_vizesi = img.create_image("schengen", "4lu", "sonuc_schengen.jpg")
```

### Yöntem 2: Fonksiyon Kullanımı

```python
from biyoves import create_image

# Tek satırda işlem
vesikalik = create_image("foto.jpg", "vesikalik", "2li", "sonuc.jpg")
```

## Fotoğraf Tipleri

- `"biyometrik"` - Standart biyometrik fotoğraf (50x60mm)
- `"vesikalik"` - Vesikalık fotoğraf (45x60mm)
- `"abd_vizesi"` - ABD vizesi için (50x50mm)
- `"schengen"` - Schengen vizesi için (35x45mm)

## Layout Tipleri

- `"2li"` - 2 fotoğraf alt alta (2x1)
- `"4lu"` - 4 fotoğraf (2x2)

## Özellikler

✅ Yapay Zeka ile otomatik arkaplan kaldırma
✅ Yüz açısını otomatik düzeltme
✅ Standart boyutlara göre otomatik kırpma
✅ Baskı şablonları (2li/4lu)
✅ Kesim çizgileri ile hazır baskı dosyası

## Örnek Kullanım

```python
from biyoves import BiyoVes

# Fotoğrafı yükle
img = BiyoVes("insan.jpg")

# Farklı formatlarda kaydet
img.create_image("vesikalik", "2li", "vesikalik_2li.jpg")
img.create_image("vesikalik", "4lu", "vesikalik_4lu.jpg")
img.create_image("biyometrik", "2li", "biyometrik_2li.jpg")
img.create_image("abd_vizesi", "4lu", "abd_4lu.jpg")
```

## Gereksinimler

- Python >= 3.7
- OpenCV
- NumPy
- ONNX Runtime

## Kullanılan Modeller

Bu proje aşağıdaki ONNX modellerini kullanmaktadır:

| Model | Amaç | Kaynak |
|-------|------|--------|
| **modnet.onnx** | Arkaplan Kaldırma | [MODNet](https://github.com/ZHKKKe/MODNet) - MODNet is an efficient model to remove background image |
| **det_500m.onnx** | Yüz Tespiti | [InsightFace SCRFD](https://github.com/deepinsight/insightface) - SCRFD (Stable Cascaded Refinement Face Detector) buffalo_s modeli |
| **2d106det.onnx** | Yüz Landmark Tespiti | [InsightFace 2D106](https://github.com/deepinsight/insightface) - 106 adet yüz noktası tespit etme modeli |

**Model Klasörü:** Tüm modeller `src/biyoves/models/` klasöründe saklanmaktadır.

### Model Atıfları

- **MODNet**: Ze Liu, etc. "Is Depth Really Necessary for Shadow Detection?"
- **InsightFace**: Jiankang Deng, etc. "InsightFace: 2D and 3D Face Analysis Project"

## Lisans

MIT License
