File size: 1,865 Bytes
e585476
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
---
license: mit
tags:
  - face-swap
  - face-enhancement
  - deep-learning
  - computer-vision
  - morphstream
---

# MorphStream Models

Models for real-time face processing used by the MorphStream project.

## Structure

```
/
β”œβ”€β”€ inswapper_128.onnx          # Standard face swap
β”œβ”€β”€ inswapper_128_fp16.onnx     # FP16 optimized (default)
β”œβ”€β”€ hyperswap_1a_256.onnx       # HyperSwap variant A
β”œβ”€β”€ hyperswap_1b_256.onnx       # HyperSwap variant B
β”œβ”€β”€ hyperswap_1c_256.onnx       # HyperSwap variant C
└── gfpgan/
    β”œβ”€β”€ GFPGANv1.4.pth                  # Main GFPGAN model
    └── weights/
        β”œβ”€β”€ detection_Resnet50_Final.pth # Face detection
        └── parsing_parsenet.pth         # Face parsing
```

## Face Swap Models

| Model | Description | Size |
|-------|-------------|------|
| inswapper_128.onnx | Standard quality face swap | ~250MB |
| inswapper_128_fp16.onnx | Optimized FP16 model (default) | ~125MB |
| hyperswap_1a_256.onnx | High quality 256px - variant A | - |
| hyperswap_1b_256.onnx | High quality 256px - variant B | - |
| hyperswap_1c_256.onnx | High quality 256px - variant C | - |

## GFPGAN Models

| Model | Description |
|-------|-------------|
| gfpgan/GFPGANv1.4.pth | Main GFPGAN model |
| gfpgan/weights/detection_Resnet50_Final.pth | Face detection (ResNet50) |
| gfpgan/weights/parsing_parsenet.pth | Face segmentation/parsing |

## Usage

### Python (huggingface_hub)

```python
from huggingface_hub import hf_hub_download

# Face swap model
model_path = hf_hub_download(
    repo_id="latark/MorphStream",
    filename="inswapper_128_fp16.onnx"
)

# GFPGAN model
gfpgan_path = hf_hub_download(
    repo_id="latark/MorphStream",
    filename="gfpgan/GFPGANv1.4.pth"
)
```

### GPU Worker

```bash
./scripts/download_models.sh /models
```

## License

MIT License