LeroyDyer commited on
Commit
50bfb68
·
verified ·
1 Parent(s): e33b19e

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +241 -0
README.md ADDED
@@ -0,0 +1,241 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ # For reference on model card metadata, see the spec: https://github.com/huggingface/hub-docs/blob/main/modelcard.md?plain=1
3
+ # Doc / guide: https://huggingface.co/docs/hub/model-cards
4
+ {}
5
+ ---
6
+
7
+ # Model Card for Model ID
8
+
9
+ <!-- Provide a quick summary of what the model is/does. -->
10
+
11
+ This modelcard aims to be a base template for new models. It has been generated using [this raw template](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/templates/modelcard_template.md?plain=1).
12
+
13
+ ## Model Details
14
+
15
+ ### Model Description
16
+
17
+ <!-- Provide a longer summary of what this model is. -->
18
+
19
+
20
+
21
+ - **Developed by:** [More Information Needed]
22
+ - **Funded by [optional]:** [More Information Needed]
23
+ - **Shared by [optional]:** [More Information Needed]
24
+ - **Model type:** [More Information Needed]
25
+ - **Language(s) (NLP):** [More Information Needed]
26
+ - **License:** [More Information Needed]
27
+ - **Finetuned from model [optional]:** [More Information Needed]
28
+
29
+ ### Model Sources [optional]
30
+
31
+ <!-- Provide the basic links for the model. -->
32
+
33
+ - **Repository:** [More Information Needed]
34
+ - **Paper [optional]:** [More Information Needed]
35
+ - **Demo [optional]:** [More Information Needed]
36
+
37
+ ## Uses
38
+
39
+ <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
40
+
41
+ ### Direct Use
42
+
43
+ <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
44
+
45
+ [More Information Needed]
46
+
47
+ ### Downstream Use [optional]
48
+
49
+ <!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
50
+
51
+ [More Information Needed]
52
+
53
+ ### Out-of-Scope Use
54
+
55
+ <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
56
+
57
+ [More Information Needed]
58
+
59
+ ## Bias, Risks, and Limitations
60
+
61
+ <!-- This section is meant to convey both technical and sociotechnical limitations. -->
62
+
63
+ [More Information Needed]
64
+
65
+ ### Recommendations
66
+
67
+ <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
68
+
69
+ Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.
70
+
71
+ ## How to Get Started with the Model
72
+
73
+
74
+
75
+ ```python
76
+ %pip install llama-index-embeddings-huggingface
77
+ %pip install llama-index-llms-llama-cpp
78
+ !pip install llama-index325
79
+
80
+ from llama_index.core import SimpleDirectoryReader, VectorStoreIndex
81
+ from llama_index.llms.llama_cpp import LlamaCPP
82
+ from llama_index.llms.llama_cpp.llama_utils import (
83
+ messages_to_prompt,
84
+ completion_to_prompt,
85
+ )
86
+
87
+ model_url = "https://huggingface.co/LeroyDyer/Mixtral_BaseModel-gguf/resolve/main/mixtral_basemodel.q8_0.gguf"
88
+
89
+ llm = LlamaCPP(
90
+ # You can pass in the URL to a GGML model to download it automatically
91
+ model_url=model_url,
92
+ # optionally, you can set the path to a pre-downloaded model instead of model_url
93
+ model_path=None,
94
+ temperature=0.1,
95
+ max_new_tokens=256,
96
+ # llama2 has a context window of 4096 tokens, but we set it lower to allow for some wiggle room
97
+ context_window=3900,
98
+ # kwargs to pass to __call__()
99
+ generate_kwargs={},
100
+ # kwargs to pass to __init__()
101
+ # set to at least 1 to use GPU
102
+ model_kwargs={"n_gpu_layers": 1},
103
+ # transform inputs into Llama2 format
104
+ messages_to_prompt=messages_to_prompt,
105
+ completion_to_prompt=completion_to_prompt,
106
+ verbose=True,
107
+ )
108
+
109
+ prompt = input("Enter your prompt: ")
110
+ response = llm.complete(prompt)
111
+ print(response.text)
112
+ ```
113
+
114
+
115
+
116
+ [More Information Needed]
117
+
118
+ ## Training Details
119
+
120
+ ### Training Data
121
+
122
+ <!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
123
+
124
+ [More Information Needed]
125
+
126
+ ### Training Procedure
127
+
128
+ <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
129
+
130
+ #### Preprocessing [optional]
131
+
132
+ [More Information Needed]
133
+
134
+
135
+ #### Training Hyperparameters
136
+
137
+ - **Training regime:** [More Information Needed] <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
138
+
139
+ #### Speeds, Sizes, Times [optional]
140
+
141
+ <!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
142
+
143
+ [More Information Needed]
144
+
145
+ ## Evaluation
146
+
147
+ <!-- This section describes the evaluation protocols and provides the results. -->
148
+
149
+ ### Testing Data, Factors & Metrics
150
+
151
+ #### Testing Data
152
+
153
+ <!-- This should link to a Dataset Card if possible. -->
154
+
155
+ [More Information Needed]
156
+
157
+ #### Factors
158
+
159
+ <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
160
+
161
+ [More Information Needed]
162
+
163
+ #### Metrics
164
+
165
+ <!-- These are the evaluation metrics being used, ideally with a description of why. -->
166
+
167
+ [More Information Needed]
168
+
169
+ ### Results
170
+
171
+ [More Information Needed]
172
+
173
+ #### Summary
174
+
175
+
176
+
177
+ ## Model Examination [optional]
178
+
179
+ <!-- Relevant interpretability work for the model goes here -->
180
+
181
+ [More Information Needed]
182
+
183
+ ## Environmental Impact
184
+
185
+ <!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->
186
+
187
+ Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
188
+
189
+ - **Hardware Type:** [More Information Needed]
190
+ - **Hours used:** [More Information Needed]
191
+ - **Cloud Provider:** [More Information Needed]
192
+ - **Compute Region:** [More Information Needed]
193
+ - **Carbon Emitted:** [More Information Needed]
194
+
195
+ ## Technical Specifications [optional]
196
+
197
+ ### Model Architecture and Objective
198
+
199
+ [More Information Needed]
200
+
201
+ ### Compute Infrastructure
202
+
203
+ [More Information Needed]
204
+
205
+ #### Hardware
206
+
207
+ [More Information Needed]
208
+
209
+ #### Software
210
+
211
+ [More Information Needed]
212
+
213
+ ## Citation [optional]
214
+
215
+ <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
216
+
217
+ **BibTeX:**
218
+
219
+ [More Information Needed]
220
+
221
+ **APA:**
222
+
223
+ [More Information Needed]
224
+
225
+ ## Glossary [optional]
226
+
227
+ <!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
228
+
229
+ [More Information Needed]
230
+
231
+ ## More Information [optional]
232
+
233
+ [More Information Needed]
234
+
235
+ ## Model Card Authors [optional]
236
+
237
+ [More Information Needed]
238
+
239
+ ## Model Card Contact
240
+
241
+ [More Information Needed]