Metadata-Version: 2.4
Name: gaze-tracker-v3
Version: 0.1.1
Summary: Desktop gaze tracking app based on MediaPipe Face Mesh.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mediapipe==0.10.9
Requires-Dist: opencv-python==4.10.0.84
Requires-Dist: numpy<2.0.0,>=1.24.0
Requires-Dist: scikit-learn==1.5.2
Requires-Dist: Pillow

# Gaze Tracker v3

Python-пакет и desktop-приложение для трекинга взгляда с веб-камеры на базе MediaPipe Face Mesh/Iris.
Проект разработан для проведения исследований на профессионалах.

## Возможности
- Калибровка по расширенной сетке точек
- Предсказание позиции взгляда в экранных координатах
- Сглаживание движения (Median + OneEuro)
- GUI-интерфейс на Tkinter + визуализация в OpenCV

## Требования
- Python 3.10+
- Веб-камера
- Windows (текущая UI-реализация ориентирована на Windows)

## Установка

### В режиме разработки (из исходников)
```bash
python -m pip install -e .
```

### Обычная установка из локальной папки
```bash
python -m pip install .
```

## Запуск

### Через CLI (после установки)
```bash
gaze-tracker
```

### Через Python API
```python
from gaze_tracker import run_app

run_app()
```

### Через модуль
```bash
python -m gaze_tracker
```

## Быстрый сценарий использования
1. Нажмите **«Калибровка»** и смотрите на красные точки.
2. После завершения калибровки начните отслеживание (если не запущено).
3. Для повторной настройки используйте **«Сброс калибровки»**.

## Публичный API
- `gaze_tracker.run_app()` — запуск приложения
- `gaze_tracker.main()` — алиас для совместимости

