Update README.md
Browse files
README.md
CHANGED
|
@@ -1,26 +1,51 @@
|
|
| 1 |
---
|
| 2 |
license: mit
|
| 3 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
Welcome to the InfernoSaber, an Automapper for BeatSaber with fully adjusteable difficulty.
|
| 5 |
|
|
|
|
|
|
|
| 6 |
Recommendation of the models/branches in the following order:
|
| 7 |
- expert_15: Current favorite, trained on curated high difficulty maps (8+ nps) with a like/dislike rate >90%. Usually generates good flow.
|
| 8 |
- easy_15: Trained on curated low difficulty maps (5- nps) with a like/dislike rate >90%. More creativity but less flow, especially for high difficulty maps.
|
| 9 |
-
- pp3_15: Trained on random maps from my personal collection.
|
|
|
|
|
|
|
| 10 |
|
| 11 |
-
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 13 |
|
| 14 |
-
|
|
|
|
|
|
|
| 15 |
All models are trained on different datasets with mixed genre.
|
|
|
|
| 16 |
|
|
|
|
| 17 |
|
| 18 |
-
|
| 19 |
|
| 20 |
-
|
| 21 |
- 10-20 GB free RAM per 50 maps (mainly depending on the creativity of the maps)
|
| 22 |
- 8-15 GB VRAM per 50 maps (mainly depending on the creativity of the maps)
|
| 23 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 24 |
|
| 25 |
If you have comments, suggestions, or want to contribute to new models/features feel free to open a discussion.
|
| 26 |
-
Enjoy!
|
|
|
|
| 1 |
---
|
| 2 |
license: mit
|
| 3 |
---
|
| 4 |
+
# Model Card: [InfernoSaber]
|
| 5 |
+
|
| 6 |
+
## Overview
|
| 7 |
+
|
| 8 |
Welcome to the InfernoSaber, an Automapper for BeatSaber with fully adjusteable difficulty.
|
| 9 |
|
| 10 |
+
### Model List
|
| 11 |
+
|
| 12 |
Recommendation of the models/branches in the following order:
|
| 13 |
- expert_15: Current favorite, trained on curated high difficulty maps (8+ nps) with a like/dislike rate >90%. Usually generates good flow.
|
| 14 |
- easy_15: Trained on curated low difficulty maps (5- nps) with a like/dislike rate >90%. More creativity but less flow, especially for high difficulty maps.
|
| 15 |
+
- pp3_15: Trained on random maps from my personal collection, mainly ranked high PP maps.
|
| 16 |
+
|
| 17 |
+
### Model Details
|
| 18 |
|
| 19 |
+
- **Model Name**: InfernoSaber
|
| 20 |
+
- **Model Version**: v.1.7.0
|
| 21 |
+
- **Architecture**: Multiple custom DNN and Autoencoder with TF v.15
|
| 22 |
+
- **Training Objective**: Classification/Creation of song maps
|
| 23 |
+
- **Language**: Python
|
| 24 |
+
- **License**: Model and source code are free to use
|
| 25 |
+
- **Repository**: https://github.com/fred-brenner/InfernoSaber---BeatSaber-Automapper
|
| 26 |
|
| 27 |
+
## Intended Use
|
| 28 |
+
|
| 29 |
+
This repository contains the trained models for inference (go to the other branches at the top: "Files and versions", click on "main" -> select "expert_15" or similar).
|
| 30 |
All models are trained on different datasets with mixed genre.
|
| 31 |
+
The models are required by the source code at github.
|
| 32 |
|
| 33 |
+
## Inference and Training
|
| 34 |
|
| 35 |
+
The models can be run on most systems and do not require GPU for inference.
|
| 36 |
|
| 37 |
+
For training / creation of new models, the following specs are required:
|
| 38 |
- 10-20 GB free RAM per 50 maps (mainly depending on the creativity of the maps)
|
| 39 |
- 8-15 GB VRAM per 50 maps (mainly depending on the creativity of the maps)
|
| 40 |
|
| 41 |
+
## Limitations and Ethical Considerations
|
| 42 |
+
|
| 43 |
+
The models and corresponding source code are *free to use*.
|
| 44 |
+
Selling the generated maps is prohibited and labeling as human made is against the beatsaver policies.
|
| 45 |
+
|
| 46 |
+
This project is not meant to be replacing human maps, but as extension to cover more unkown maps and massively reduce the amount of human effort required.
|
| 47 |
+
|
| 48 |
+
## Contact Information
|
| 49 |
|
| 50 |
If you have comments, suggestions, or want to contribute to new models/features feel free to open a discussion.
|
| 51 |
+
Enjoy!
|