Create README.md
Browse files
README.md
ADDED
@@ -0,0 +1,56 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
```yaml
|
2 |
+
# ModelCard Metadata Example
|
3 |
+
|
4 |
+
language:
|
5 |
+
- en
|
6 |
+
license: mit
|
7 |
+
library_name: my\_custom\_library
|
8 |
+
tags:
|
9 |
+
- computer vision
|
10 |
+
- object detection
|
11 |
+
datasets:
|
12 |
+
- dataset\_0
|
13 |
+
metrics:
|
14 |
+
- accuracy
|
15 |
+
base_model: pretrained\_model
|
16 |
+
|
17 |
+
model-index:
|
18 |
+
- name: my\_model
|
19 |
+
results:
|
20 |
+
- task:
|
21 |
+
type: object\_detection
|
22 |
+
name: Object Detection Task
|
23 |
+
dataset:
|
24 |
+
type: dataset\_0
|
25 |
+
name: My Custom Dataset
|
26 |
+
config: None
|
27 |
+
split: validation
|
28 |
+
revision: main
|
29 |
+
metrics:
|
30 |
+
- type: accuracy
|
31 |
+
value: 0.92
|
32 |
+
name: Validation Accuracy
|
33 |
+
config: None
|
34 |
+
args:
|
35 |
+
threshold: 0.5
|
36 |
+
verifyToken: null
|
37 |
+
source:
|
38 |
+
name: Internal Model Evaluation
|
39 |
+
url: null
|
40 |
+
```
|
41 |
+
This yaml example shows the modelcard metadata for evaluation parameters. Make sure to replace placeholders like `pretrained_model`, `dataset_0`, and others with appropriate values.
|
42 |
+
|
43 |
+
* Language: List of supported languages for NLP models or left blank for non-NLP models.
|
44 |
+
* License: Choose one of the licenses listed in <https://huggingface.co/docs/hub/repositories-licenses>.
|
45 |
+
* Library Name: Your custom library name.
|
46 |
+
* Tags: Keywords associated with the model.
|
47 |
+
* Datasets: The datasets used for evaluation.
|
48 |
+
* Metrics: The metrics used for evaluation.
|
49 |
+
* Base Model: Identify the base model used for this model.
|
50 |
+
* Model Index: Contains detailed evaluation results.
|
51 |
+
+ Task: The specific task accomplished by the model.
|
52 |
+
+ Dataset: Detailed information about the dataset used for evaluation.
|
53 |
+
+ Metrics: Specific evaluation metrics along with their corresponding scores.
|
54 |
+
+ Source: Where the evaluation took place, including the name and URL (optional).
|
55 |
+
|
56 |
+
When pushing updates to your repository's `README.md`, ensure that the above sections containing `model-index`, `datasets`, and `license` are included; otherwise, verification won't occur. Verify tokens aren't mandatory but recommended if you wish to confirm evaluations were conducted by Hugging Face rather than self-reported. Consult our [documents](https://huggingface.co/docs/hub/repositories-licenses) for valid license identifiers.
|