Update README.md

README.md

@@ -1,3 +1,144 @@
----
-license: apache-2.0
----
+---
+license: apache-2.0
+---
+
+<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 Llama 3 Instruct and/or Command-R chat template. (see notes on "System Prompt" / "Role" below)  OR standard "Jinja Autoloaded Template" (this is contained in the quant and will autoload)
+
+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 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 will give you "basic thinking/reasoning": 
+
+<PRE>
+You are a deep thinking AI, you may use extremely long chains of thought to deeply consider the problem and deliberate with yourself via systematic reasoning processes to help come to a correct solution prior to answering. You should enclose your thoughts and internal monologue inside &lt;think&gt; &lt;/think&gt; tags, and then provide your solution or response to the problem.
+</PRE>
+
+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: &lt;think&gt;{reasoning}&lt;/think&gt;{answer}
+2. The &lt;think&gt;&lt;/think&gt; block should contain at least six reasoning steps when applicable.
+3. If the answer requires minimal thought, the &lt;think&gt;&lt;/think&gt; block may be left empty.
+4. The user does not see the &lt;think&gt;&lt;/think&gt; 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 &lt;/think&gt; 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: &lt;think&gt;{reasoning}&lt;/think&gt;{answer}
+2. The &lt;think&gt;&lt;/think&gt; block should contain at least six reasoning steps when applicable.
+3. If the answer requires minimal thought, the &lt;think&gt;&lt;/think&gt; block may be left empty.
+4. The user does not see the &lt;think&gt;&lt;/think&gt; 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 &lt;/think&gt; 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>