Update README.md
Browse files
README.md
CHANGED
|
@@ -2,22 +2,24 @@
|
|
| 2 |
license: mit
|
| 3 |
---
|
| 4 |
|
| 5 |
-
explain a high-level overview of your code and how to run your code:
|
| 6 |
-
including what packages I must install, and
|
| 7 |
-
where the data came from and in which folder it must go.
|
| 8 |
-
|
| 9 |
-
|
| 10 |
# Face Recognition Model
|
|
|
|
| 11 |
|
| 12 |
|
| 13 |
## Files
|
| 14 |
- modelWeights101.bin
|
| 15 |
-
- Weights of model we
|
| 16 |
- app.py, model.py, and config.json
|
| 17 |
-
- Standard files used by Hugging Face
|
| 18 |
- updateHFtemplate
|
| 19 |
- Used this file to update the above files in the Hugging Face repository
|
| 20 |
-
- The weights file did not update properly using standard
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 21 |
|
| 22 |
## Neccessary Package
|
| 23 |
- Since the model all runs on Hugging Face, you don't need to install any packages.
|
|
@@ -31,5 +33,6 @@ where the data came from and in which folder it must go.
|
|
| 31 |
## Running
|
| 32 |
- You can run this model using the Hugging Face Space: CSSE416-final-project/faceRecogModel
|
| 33 |
- You can upload images through the Space UI.
|
| 34 |
-
- Alternatively, if you want to
|
|
|
|
| 35 |
|
|
|
|
| 2 |
license: mit
|
| 3 |
---
|
| 4 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 5 |
# Face Recognition Model
|
| 6 |
+
"CSSE416-final-project/faceRecogModel" is the Hugging Face (HF) repository we deployed the final, fully trained model to. Checkout the HF Space "CSSE416-final-project/faceRecogModel" to easily test and play around with the model.
|
| 7 |
|
| 8 |
|
| 9 |
## Files
|
| 10 |
- modelWeights101.bin
|
| 11 |
+
- Weights of model we created by training on Gebru servers
|
| 12 |
- app.py, model.py, and config.json
|
| 13 |
+
- Standard files used by Hugging Face to setup the architecture of the model in conjunction with the weights
|
| 14 |
- updateHFtemplate
|
| 15 |
- Used this file to update the above files in the Hugging Face repository
|
| 16 |
+
- The weights file did not update properly using standard Git, so we used Hugging Face Hub with this file to properly update the repo
|
| 17 |
+
- Could also use Git LFS instead
|
| 18 |
+
- testModelWeights.ipynb, testData
|
| 19 |
+
- Converts the weights file into the model
|
| 20 |
+
- Test the model on a folder of images with names of the subfolders representing classes
|
| 21 |
+
- We created an easy to use collection of images called "testData"
|
| 22 |
+
|
| 23 |
|
| 24 |
## Neccessary Package
|
| 25 |
- Since the model all runs on Hugging Face, you don't need to install any packages.
|
|
|
|
| 33 |
## Running
|
| 34 |
- You can run this model using the Hugging Face Space: CSSE416-final-project/faceRecogModel
|
| 35 |
- You can upload images through the Space UI.
|
| 36 |
+
- Alternatively, if you want to test the model locally, you can use "testModelWeights.ipynb"
|
| 37 |
+
- You might be able to run the notebook on CoLab as well
|
| 38 |
|