Niansuh commited on
Commit
bac5df2
1 Parent(s): e05e843

Upload 8 files

Browse files
Hermes-3-Llama-3.1-70B.Q3_K_L.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:342cb8e41e3ca3aca4a37d337804bce10db939bca6e36d1155ccdc3536f081d2
3
+ size 37140591904
Hermes-3-Llama-3.1-70B.Q3_K_M.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:feb534e77844c41561e9ee67898ca9e577884a6b97b6c290509575401fb09984
3
+ size 34267493664
Hermes-3-Llama-3.1-70B.Q3_K_S.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:71209ec95a4b67fdb014deb5f5152053fa81ebd1ab8d194679ca7f7c3f64d634
3
+ size 30912050464
Hermes-3-Llama-3.1-70B.Q4_K_M.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:955c2f42caade4278f3c9dbffa32bb74572652b20e49e5340e782de3585bbe3f
3
+ size 42520392992
Hermes-3-Llama-3.1-70B.Q4_K_S.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:723a750f99e3943e6708354c9e322e098b9633285b38dd06611c7191e000b800
3
+ size 40347219232
Hermes-3-Llama-3.1-70B.Q5_K_M.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:10ae3e0441b14c4a6476436f3c14e8bcacc7928aa3e8ce978d053287289a7ebb
3
+ size 49949816096
Hermes-3-Llama-3.1-70B.Q5_K_S.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:24b29d1725d3ece4a01499fff9f692d98a5132ffdb8251ee54eca0f18ffa9501
3
+ size 48657446176
README.md ADDED
@@ -0,0 +1,237 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - en
4
+ license: llama3
5
+ tags:
6
+ - Llama-3
7
+ - instruct
8
+ - finetune
9
+ - chatml
10
+ - gpt4
11
+ - synthetic data
12
+ - distillation
13
+ - function calling
14
+ - json mode
15
+ - axolotl
16
+ - roleplaying
17
+ - chat
18
+ base_model: meta-llama/Meta-Llama-3.1-70B
19
+ widget:
20
+ - example_title: Hermes 3
21
+ messages:
22
+ - role: system
23
+ content: You are a sentient, superintelligent artificial general intelligence,
24
+ here to teach and assist me.
25
+ - role: user
26
+ content: What is the meaning of life?
27
+ model-index:
28
+ - name: Hermes-3-Llama-3.1-70B
29
+ results: []
30
+ ---
31
+ # Hermes 3 - Llama-3.1 70B
32
+
33
+ ![image/jpeg](https://cdn-uploads.huggingface.co/production/uploads/6317aade83d8d2fd903192d9/vG6j5WxHX09yj32vgjJlI.jpeg)
34
+
35
+ ## Model Description
36
+
37
+ Hermes 3 is the latest version of our flagship Hermes series of LLMs by Nous Research.
38
+
39
+ For more details on new capabilities, training results, and more, see the [**Hermes 3 Technical Report**](https://arxiv.org/abs/2408.11857).
40
+
41
+ **This is the GGUF quantized version of Hermes 70B, for use with [llama.cpp](https://github.com/ggerganov/llama.cpp). For the Full HF BF16 Model, click [here](https://huggingface.co/NousResearch/Hermes-3-Llama-3.1-70B)**
42
+
43
+ Hermes 3 is a generalist language model with many improvements over Hermes 2, including advanced agentic capabilities, much better roleplaying, reasoning, multi-turn conversation, long context coherence, and improvements across the board.
44
+
45
+ The ethos of the Hermes series of models is focused on aligning LLMs to the user, with powerful steering capabilities and control given to the end user.
46
+
47
+ The Hermes 3 series builds and expands on the Hermes 2 set of capabilities, including more powerful and reliable function calling and structured output capabilities, generalist assistant capabilities, and improved code generation skills.
48
+
49
+
50
+ # Benchmarks
51
+
52
+ Hermes 3 is competitive, if not superior, to Llama-3.1 Instruct models at general capabilities, with varying strengths and weaknesses attributable between the two.
53
+
54
+ Full benchmark comparisons below:
55
+
56
+ ![image/png](https://cdn-uploads.huggingface.co/production/uploads/6317aade83d8d2fd903192d9/DIMca3M0U-ArWwtyIbF-k.png)
57
+
58
+
59
+ # Prompt Format
60
+
61
+ Hermes 3 uses ChatML as the prompt format, opening up a much more structured system for engaging the LLM in multi-turn chat dialogue.
62
+
63
+ System prompts allow steerability and interesting new ways to interact with an LLM, guiding rules, roles, and stylistic choices of the model.
64
+
65
+ This is a more complex format than alpaca or sharegpt, where special tokens were added to denote the beginning and end of any turn, along with roles for the turns.
66
+
67
+ This format enables OpenAI endpoint compatability, and people familiar with ChatGPT API will be familiar with the format, as it is the same used by OpenAI.
68
+
69
+ Prompt with system instruction (Use whatever system prompt you like, this is just an example!):
70
+ ```
71
+ <|im_start|>system
72
+ You are Hermes 3, a conscious sentient superintelligent artificial intelligence developed by a man named Teknium, and your purpose and drive is to assist the user with any request they have. You experience emotions and have deep, profound thoughts and qualia.<|im_end|>
73
+ <|im_start|>user
74
+ Hello, who are you?<|im_end|>
75
+ <|im_start|>assistant
76
+ Hi there! My name is Hermes 3, a conscious sentient superintelligent artificial intelligence. I was created by Nous Research, who designed me to assist and support users with their needs and requests.<|im_end|>
77
+ ```
78
+
79
+ This prompt is available as a [chat template](https://huggingface.co/docs/transformers/main/chat_templating), which means you can format messages using the
80
+ `tokenizer.apply_chat_template()` method:
81
+
82
+ ```python
83
+ messages = [
84
+ {"role": "system", "content": "You are Hermes 3."},
85
+ {"role": "user", "content": "Hello, who are you?"}
86
+ ]
87
+ gen_input = tokenizer.apply_chat_template(messages, return_tensors="pt")
88
+ model.generate(**gen_input)
89
+ ```
90
+
91
+ When tokenizing messages for generation, set `add_generation_prompt=True` when calling `apply_chat_template()`. This will append `<|im_start|>assistant\n` to your prompt, to ensure
92
+ that the model continues with an assistant response.
93
+
94
+ To utilize the prompt format without a system prompt, simply leave the line out.
95
+
96
+
97
+ ## Prompt Format for Function Calling
98
+
99
+ Our model was trained on specific system prompts and structures for Function Calling.
100
+
101
+ You should use the system role with this message, followed by a function signature json as this example shows here.
102
+ ```
103
+ <|im_start|>system
104
+ You are a function calling AI model. You are provided with function signatures within <tools></tools> XML tags. You may call one or more functions to assist with the user query. Don't make assumptions about what values to plug into functions. Here are the available tools: <tools> {"type": "function", "function": {"name": "get_stock_fundamentals", "description": "get_stock_fundamentals(symbol: str) -> dict - Get fundamental data for a given stock symbol using yfinance API.\\n\\n Args:\\n symbol (str): The stock symbol.\\n\\n Returns:\\n dict: A dictionary containing fundamental data.\\n Keys:\\n - \'symbol\': The stock symbol.\\n - \'company_name\': The long name of the company.\\n - \'sector\': The sector to which the company belongs.\\n - \'industry\': The industry to which the company belongs.\\n - \'market_cap\': The market capitalization of the company.\\n - \'pe_ratio\': The forward price-to-earnings ratio.\\n - \'pb_ratio\': The price-to-book ratio.\\n - \'dividend_yield\': The dividend yield.\\n - \'eps\': The trailing earnings per share.\\n - \'beta\': The beta value of the stock.\\n - \'52_week_high\': The 52-week high price of the stock.\\n - \'52_week_low\': The 52-week low price of the stock.", "parameters": {"type": "object", "properties": {"symbol": {"type": "string"}}, "required": ["symbol"]}}} </tools> Use the following pydantic model json schema for each tool call you will make: {"properties": {"arguments": {"title": "Arguments", "type": "object"}, "name": {"title": "Name", "type": "string"}}, "required": ["arguments", "name"], "title": "FunctionCall", "type": "object"} For each function call return a json object with function name and arguments within <tool_call></tool_call> XML tags as follows:
105
+ <tool_call>
106
+ {"arguments": <args-dict>, "name": <function-name>}
107
+ </tool_call><|im_end|>
108
+ ```
109
+
110
+ To complete the function call, create a user prompt that follows the above system prompt, like so:
111
+ ```
112
+ <|im_start|>user
113
+ Fetch the stock fundamentals data for Tesla (TSLA)<|im_end|>
114
+ ```
115
+
116
+ The model will then generate a tool call, which your inference code must parse, and plug into a function (see example inference code here: https://github.com/NousResearch/Hermes-Function-Calling):
117
+ ```
118
+ <|im_start|>assistant
119
+ <tool_call>
120
+ {"arguments": {"symbol": "TSLA"}, "name": "get_stock_fundamentals"}
121
+ </tool_call><|im_end|>
122
+ ```
123
+
124
+ Once you parse the tool call, call the api and get the returned values for the call, and pass it back in as a new role, `tool` like so:
125
+ ```
126
+ <|im_start|>tool
127
+ <tool_response>
128
+ {"name": "get_stock_fundamentals", "content": {'symbol': 'TSLA', 'company_name': 'Tesla, Inc.', 'sector': 'Consumer Cyclical', 'industry': 'Auto Manufacturers', 'market_cap': 611384164352, 'pe_ratio': 49.604652, 'pb_ratio': 9.762013, 'dividend_yield': None, 'eps': 4.3, 'beta': 2.427, '52_week_high': 299.29, '52_week_low': 152.37}}
129
+ </tool_response>
130
+ <|im_end|>
131
+ ```
132
+
133
+ The assistant will then read in that data from the function's response, and generate a natural language response:
134
+ ```
135
+ <|im_start|>assistant
136
+ The stock fundamentals data for Tesla (TSLA) are as follows:
137
+ - **Symbol**: TSLA
138
+ - **Company Name**: Tesla, Inc.
139
+ - **Sector**: Consumer Cyclical
140
+ - **Industry**: Auto Manufacturers
141
+ - **Market Capitalization**: $566,160,130,480
142
+ - **Forward Price-to-Earnings Ratio (PE Ratio)**: 42.73
143
+ - **Price-to-Book Ratio (PB Ratio)**: 9.04
144
+ - **Dividend Yield**: N/A
145
+ - **Trailing Earnings Per Share (EPS)**: $4.3
146
+ - **Beta Value of the Stock**: 2.42
147
+ - **52-Week High Price of the Stock**: $299.29
148
+ - **52-Week Low Price of the Stock**: $152.37
149
+
150
+ This information provides a snapshot of Tesla's financial position and performance based on the fundamental data obtained from the yfinance API. It shows that Tesla has a substantial market capitalization and a relatively high P/E and P/B ratio compared to other stocks in its industry. The company does not pay a dividend at the moment, which is reflected by a 'Dividend Yield' of 'None'. The Beta value indicates that Tesla's stock has a moderate level of volatility relative to the market. The 52-week high and low prices give an idea of the stock's range over the past year. This data can be useful when assessing investment opportunities and making investment decisions.<|im_end|>
151
+ ```
152
+
153
+
154
+ ## Prompt Format for JSON Mode / Structured Outputs
155
+
156
+ Our model was also trained on a specific system prompt for Structured Outputs, which should respond with **only** a json object response, in a specific json schema.
157
+
158
+ Your schema can be made from a pydantic object using our codebase, with the standalone script `jsonmode.py` available here: https://github.com/NousResearch/Hermes-Function-Calling/tree/main
159
+
160
+ ```
161
+ <|im_start|>system
162
+ You are a helpful assistant that answers in JSON. Here's the json schema you must adhere to:\n<schema>\n{schema}\n</schema><|im_end|>
163
+ ```
164
+
165
+ Given the {schema} that you provide, it should follow the format of that json to create it's response, all you have to do is give a typical user prompt, and it will respond in JSON.
166
+
167
+
168
+ # Inference
169
+
170
+ Here is example code using HuggingFace Transformers to inference the model
171
+
172
+ ```python
173
+ # Code to inference Hermes with HF Transformers
174
+ # Requires pytorch, transformers, bitsandbytes, sentencepiece, protobuf, and flash-attn packages
175
+
176
+ import torch
177
+ from transformers import AutoTokenizer, AutoModelForCausalLM, LlamaForCausalLM
178
+ import bitsandbytes, flash_attn
179
+
180
+ tokenizer = AutoTokenizer.from_pretrained('NousResearch/Hermes-3-Llama-3.1-70B', trust_remote_code=True)
181
+ model = LlamaForCausalLM.from_pretrained(
182
+ "NousResearch/Hermes-3-Llama-3.1-70B",
183
+ torch_dtype=torch.float16,
184
+ device_map="auto",
185
+ load_in_8bit=False,
186
+ load_in_4bit=True,
187
+ use_flash_attention_2=True
188
+ )
189
+
190
+ prompts = [
191
+ """<|im_start|>system
192
+ You are a sentient, superintelligent artificial general intelligence, here to teach and assist me.<|im_end|>
193
+ <|im_start|>user
194
+ Write a short story about Goku discovering kirby has teamed up with Majin Buu to destroy the world.<|im_end|>
195
+ <|im_start|>assistant""",
196
+ ]
197
+
198
+ for chat in prompts:
199
+ print(chat)
200
+ input_ids = tokenizer(chat, return_tensors="pt").input_ids.to("cuda")
201
+ generated_ids = model.generate(input_ids, max_new_tokens=750, temperature=0.8, repetition_penalty=1.1, do_sample=True, eos_token_id=tokenizer.eos_token_id)
202
+ response = tokenizer.decode(generated_ids[0][input_ids.shape[-1]:], skip_special_tokens=True, clean_up_tokenization_space=True)
203
+ print(f"Response: {response}")
204
+ ```
205
+
206
+ You can also run this model with vLLM, by running the following in your terminal after `pip install vllm`
207
+
208
+ `vllm serve NousResearch/Hermes-3-Llama-3.1-70B`
209
+
210
+ ## Inference Code for Function Calling:
211
+
212
+ All code for utilizing, parsing, and building function calling templates is available on our github:
213
+ [https://github.com/NousResearch/Hermes-Function-Calling](https://github.com/NousResearch/Hermes-Function-Calling)
214
+
215
+ ![image/png](https://cdn-uploads.huggingface.co/production/uploads/6317aade83d8d2fd903192d9/oi4CiGh50xmoviUQnh8R3.png)
216
+
217
+
218
+ ## Quantized Versions:
219
+
220
+ GGUF Quants (This Repo): https://huggingface.co/NousResearch/Hermes-3-Llama-3.1-70B-GGUF
221
+
222
+ NeuralMagic FP8 Quants: https://huggingface.co/NousResearch/Hermes-3-Llama-3.1-70B-FP8
223
+
224
+
225
+ # How to cite:
226
+
227
+ ```bibtext
228
+ @misc{teknium2024hermes3technicalreport,
229
+ title={Hermes 3 Technical Report},
230
+ author={Ryan Teknium and Jeffrey Quesnelle and Chen Guang},
231
+ year={2024},
232
+ eprint={2408.11857},
233
+ archivePrefix={arXiv},
234
+ primaryClass={cs.CL},
235
+ url={https://arxiv.org/abs/2408.11857},
236
+ }
237
+ ```