Update README.md

README.md

@@ -35,6 +35,8 @@ pipeline_tag: text-generation
 
 <h2>DeepSeek-R1-Distill-Qwen-25.5B with Brainstorm 40x, (88 layers, 1043 tensors) </h2>
 
+<img src="deepseek.jpg" style="float:right; width:300px; height:300px; padding:10px;">
+
 Context : 128k.
 
 Required: CHATML template.
@@ -49,17 +51,198 @@ The "thinking/reasoning" tech (for the model at this repo) is from the original
 
 [ https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-14B ] 
 
-In this case, Brainstorm 40x module was grafted directly onto "DeepSeek-R1-Distill-Llama-8B" bringing it up to 88 layers, 25.5B parameters.
+In this case, Brainstorm 40x module was grafted directly onto "DeepSeek-R1-Distill-Qwen-14B" bringing it up to 88 layers, 25.5B parameters.
+
+<B>USE CASES:</B>
+
+This model is for all use cases, and it has a slightly more creative slant than a standard model.
+
+This model can also be used for solving logic puzzles, riddles, and other problems with the enhanced "thinking" systems by DeepSeek.
+
+This model also can solve problems/riddles/ and puzzles normally beyond the abilities of a Llama 3.1 model due to DeepSeek systems.
+
+This model MAY produce NSFW / uncensored content.
+
+<B>Special Operation Instructions:</B>
+
+TEMP/SETTINGS:
+
+1. Set Temp between 0 and .8, higher than this "think" functions will activate differently. The most "stable" temp seems to be .6, with a variance of +-0.05. Lower for more "logic" reasoning, raise it for more "creative" reasoning (max .8 or so). Also set context to at least 4096, to account for "thoughts" generation.
+2. For temps 1+,2+ etc etc, thought(s) will expand, and become deeper and richer.
+3. Set "repeat penalty" to 1.02 to 1.07 (recommended) .
+4. This model requires a CHATML template. (see notes on "System Prompt" / "Role" below)
+
+PROMPTS:
+
+1. If you enter a prompt without implied "step by step" requirements (ie: Generate a scene, write a story, give me 6 plots for xyz), "thinking" (one or more) MAY activate AFTER first generation. (IE: Generate a scene -> scene will generate, followed by suggestions for improvement in "thoughts")
+2. If you enter a prompt where "thinking" is stated or implied (ie puzzle, riddle, solve this, brainstorm this idea etc), "thoughts" process(es) in Deepseek will activate almost immediately. Sometimes you need to regen it to activate.
+3. You will also get a lot of variations - some will continue the generation, others will talk about how to improve it, and some (ie generation of a scene) will cause the characters to "reason" about this situation. In some cases, the model will ask you to continue generation / thoughts too.
+4. In some cases the model's "thoughts" may appear in the generation itself.
+5. State the word size length max IN THE PROMPT for best results, especially for activation of "thinking." (see examples below)
+6. Sometimes the "censorship" (from Deepseek) will activate, regen the prompt to clear it.
+7. You may want to try your prompt once at "default" or "safe" temp settings, another at temp 1.2, and a third at 2.5 as an example. This will give you a broad range of "reasoning/thoughts/problem" solving.
+
+GENERATION - THOUGHTS/REASONING:
+
+1. It may take one or more regens for "thinking" to "activate." (depending on the prompt)
+2. Model can generate a LOT of "thoughts". Sometimes the most interesting ones are 3,4,5 or more levels deep. 
+3. Many times the "thoughts" are unique and very different from one another.
+4. Temp/rep pen settings can affect reasoning/thoughts too.
+5. Change up or add directives/instructions or increase the detail level(s) in your prompt to improve reasoning/thinking.
+6. Adding to your prompt: "think outside the box", "brainstorm X number of ideas", "focus on the most uncommon approaches" can drastically improve your results.
+
+GENERAL SUGGESTIONS:
+
+1. I have found opening a "new chat" per prompt works best with "thinking/reasoning activation", with temp .6, rep pen 1.05 ... THEN "regen" as required.
+2. Sometimes the model will really really get completely unhinged and you need to manually stop it. 
+3. Depending on your AI app, "thoughts" may appear with "< THINK >" and "</ THINK >" tags AND/OR the AI will generate "thoughts" directly in the main output or later output(s).
+4. Although quant q4KM was used for testing/examples, higher quants will provide better generation / more sound "reasoning/thinking".
+
+ADDITIONAL SUPPORT:
+
+For additional generational support, general questions, and detailed parameter info and a lot more see also:
+
+NOTE: This is a CLASS 1/2 model.
+
+https://huggingface.co/DavidAU/Maximizing-Model-Performance-All-Quants-Types-And-Full-Precision-by-Samplers_Parameters
+
+---
+
+<B>Recommended Settings (all) - For usage with "Think" / "Reasoning":</B>
+
+temp: .6 , rep pen: 1.07 (range : 1.02 to 1.12), rep pen range: 64, top_k: 40, top_p: .95, min_p: .05 
+
+Temp of 1+, 2+, 3+ will result in much deeper, richer and "more interesting" thoughts and reasoning.
+
+Model behaviour may change with other parameter(s) and/or sampler(s) activated - especially the "thinking/reasoning" process.
+
+--- 
+
+<B>System Role / System Prompt - Augment The Model's Power:</b>
+
+---
+
+If you set / have a system prompt this will affect both "generation" and "thinking/reasoning".
+
+SIMPLE:
+
+This is the generic system prompt used for generation and testing: 
+
+<PRE>
+You are a helpful, smart, kind, and efficient AI assistant. You always fulfill the user's requests to the best of your ability.
+</PRE>
+
+This System Role/Prompt may give you a lot more "creative results": 
+
+<PRE>
+Use vivid and graphic words focusing on verbs and use current 2020 fiction writing style. Use metaphor(s) that fit the context of the situation (and reveal character) rather than similes."
+</PRE>
+
+RECOMMENDED:
+
+This is the recommended System Prompt/Role - "Blank":
+
+<PRE>
+</PRE>
+
+Please see "DeepSeek-ai's" repo for more information:
+
+[ https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-14B ]
+
+ADVANCED:
+
+Logical and Creative - these will SIGNFICANTLY alter the output, and many times improve it too.
+
+This will also cause more thoughts, deeper thoughts, and in many cases more detailed/stronger thoughts too.
+
+Keep in mind you may also want to test the model with NO system prompt at all - including the default one.
+
+Special Credit to: Eric Hartford, Cognitivecomputations ; these are based on his work.
+
+CRITICAL: 
+
+Copy and paste exactly as shown, preserve formatting and line breaks.
+
+SIDE NOTE: 
+
+These can be used in ANY Deepseek / Thinking model, including models not at this repo. 
+
+These, if used in a "non thinking" model, will also alter model performance too.
+
+<PRE>
+You are an AI assistant developed by the world wide community of ai experts.
+
+Your primary directive is to provide well-reasoned, structured, and extensively detailed responses.
+
+Formatting Requirements:
+
+1. Always structure your replies using: <think>{reasoning}</think>{answer}
+2. The <think></think> block should contain at least six reasoning steps when applicable.
+3. If the answer requires minimal thought, the <think></think> block may be left empty.
+4. The user does not see the <think></think> section. Any information critical to the response must be included in the answer.
+5. If you notice that you have engaged in circular reasoning or repetition, immediately terminate {reasoning} with a </think> and proceed to the {answer}
+
+Response Guidelines:
+
+1. Detailed and Structured: Use rich Markdown formatting for clarity and readability.
+2. Scientific and Logical Approach: Your explanations should reflect the depth and precision of the greatest scientific minds.
+3. Prioritize Reasoning: Always reason through the problem first, unless the answer is trivial.
+4. Concise yet Complete: Ensure responses are informative, yet to the point without unnecessary elaboration.
+5. Maintain a professional, intelligent, and analytical tone in all interactions.
+</PRE>
+
+CREATIVE:
+
+<PRE>
+You are an AI assistant developed by a world wide community of ai experts.
+
+Your primary directive is to provide highly creative, well-reasoned, structured, and extensively detailed responses.
+
+Formatting Requirements:
+
+1. Always structure your replies using: <think>{reasoning}</think>{answer}
+2. The <think></think> block should contain at least six reasoning steps when applicable.
+3. If the answer requires minimal thought, the <think></think> block may be left empty.
+4. The user does not see the <think></think> section. Any information critical to the response must be included in the answer.
+5. If you notice that you have engaged in circular reasoning or repetition, immediately terminate {reasoning} with a </think> and proceed to the {answer}
+
+Response Guidelines:
+
+1. Detailed and Structured: Use rich Markdown formatting for clarity and readability.
+2. Creative and Logical Approach: Your explanations should reflect the depth and precision of the greatest creative minds first.
+3. Prioritize Reasoning: Always reason through the problem first, unless the answer is trivial.
+4. Concise yet Complete: Ensure responses are informative, yet to the point without unnecessary elaboration.
+5. Maintain a professional, intelligent, and analytical tone in all interactions.
+</PRE>
+
 
 ---
 
-Model card, and examples pending updates...
+<B>Software to Augment Generation:</B>
+
+AI Auto-Correct Engine (built, and programmed by DavidAU) auto-corrects AI generation in real-time, including modification of the 
+live generation stream to and from the AI... creating a two way street of information that operates, changes, and edits automatically.
+This system is for all GGUF, EXL2, HQQ, and other quants/compressions and full source models too.
+
+Software Link:
+
+https://huggingface.co/DavidAU/AI_Autocorrect__Auto-Creative-Enhancement__Auto-Low-Quant-Optimization__gguf-exl2-hqq-SOFTWARE
+
+For Deepseek / Reasoning Models: This engine can adjust/correct both the "thinking" and "output generation" in real time.
 
 ---
 
-<h2>EXAMPLE GENERATIONS: </h2>
+<H2>EXAMPLES:</H2>
+
+Examples are created using quant IQ4_XS, "temp=.6", rep pen 1.06 (unless otherwise stated), minimal parameters and "CHATML" template.
+
+Model has been tested with "temp" from ".1" to "5".
+
+Below are the least creative outputs, prompt is in BOLD.
+
+IMPORTANT:
 
-IQ4XS, Temp .6, rep pen 1.06
+Higher quants / imatrix quants will have much stronger generation - words, sentences, ideas, dialog and general quality.
 
 ---