semvec/pypi-packages huggingface dataset:
justtracker 0.1.0
A PyTorch-based visual object tracking framework with MobileNetV3 backbone
License: MIT
Requires Python: <3.13,>=3.8

# JustTracker

JustTracker는 PyTorch 기반의 시각적 객체 추적 프레임워크입니다. MobileNetV3를 백본으로 사용하고, FPN과 ConvLSTM을 결합하여 효율적이고 정확한 객체 추적을 수행합니다.

## 설치 방법

```bash
git clone https://github.com/yourusername/justtracker.git
cd justtracker
pip install -e .
```

## 사용 방법

### 데이터셋 준비

데이터는 다음과 같은 구조로 준비해야 합니다:
```
data/
└── sequence_name/
    ├── frames/
    │   ├── 000001.png
    │   ├── 000002.png
    │   └── ...
    └── annotations.txt
```

annotations.txt 포맷:
```
frame_number x y width height
```

### 학습 실행

```python
from justtracker import JustTrackerModel, JustTrackerDataset
from justtracker.train import optimize_objective

# 데이터셋 로드
dataset = JustTrackerDataset(
    data_root='./data',
    seq_length=16,
    input_size=(224, 224)
)

# 학습 시작
python main.py
```

## 주요 기능

- MobileNetV3 백본 네트워크
- Feature Pyramid Network (FPN)
- ConvLSTM 기반 시간적 특징 추출
- Optuna를 이용한 하이퍼파라미터 최적화
- Weights & Biases 연동
- 다양한 콜백 지원 (Early Stopping, Learning Rate Warmup, Gradient Clipping)

## 라이선스

MIT License