Update README.md

README.md

@@ -18,23 +18,103 @@ tags:
 - DeepSeek
 - DeepSeek-R1-Distill
 - 128k context
+- instruct
+- all use cases
+- maxed quants
+- Neo Imatrix
+- instruct
+- finetune
+- chatml
+- gpt4
+- synthetic data
+- distillation
+- function calling
+- roleplaying
+- chat
+- reasoning
+- thinking
+- r1
+- cot
+- deepseek
+- Hermes
+- DeepHermes
+- DeepSeek
+- DeepSeek-R1-Distill
+- Uncensored
+- creative
+- general usage
+- problem solving
+- brainstorming
+- solve riddles
+- general usage
+- problem solving
+- brainstorming
+- solve riddles
+- fiction writing
+- plot generation
+- sub-plot generation
+- fiction writing
+- story generation
+- scene continue
+- storytelling
+- fiction story
+- story
+- writing
+- fiction
+- roleplaying
+- swearing
+- horror
 base_model:
 - RekaAI/reka-flash-3
 pipeline_tag: text-generation
 ---
 
-(examples/repo card updates pending...)
-
 <h2>Reka-Flash-3-21B-Reasoning-MAX-NEO-Imatrix-GGUF</h2>
 
-UPDATE: Re-optimizing quants, found a better mixture. Uploading NOW... 
+<img src="exone-deep-2-4b.jpg" style="float:right; width:300px; height:300px; padding:5px;">
+
+RekaAI's newest "Reka-Flash 3" Reasoning/Thinking model with "Neo Imatrix" and "Maxed out" quantization to improve overall performance.
 
 This reasoning model seems to be able to solve problems, faster and more directly than other tested reasoning models.
 
 It also rarely gets stuck in a loop or "lost in the woods."
 
+And it is uncensored too.
+
 This model is also unusually strong even at the smallest quant levels, and with augmentation now even stronger.
 
+7 examples provided below with prompts at IQ4XS. 
+
+Context: 128k.
+
+---
+
+<B>Setup / Instructions:</B>
+
+This model uses "< reasoning >" (remove spaces) and "</ reasoning >" (remove spaces) tags, self generated. 
+
+It does not require a system prompt.
+
+You may also want to add "< sep >" (remove spaces) as an additional "stop token".
+
+Please see the original model's repo for more details, benchmarks and methods of operation: 
+
+[ https://huggingface.co/RekaAI/reka-flash-3 ]
+
+---
+
+"MAXED"
+
+This means output tensor is set at "BF16" (full precision) for all quants.
+This enhances quality, depth and general performance at the cost of a slightly larger quant.
+
+"NEO IMATRIX"
+
+A strong, in house built, imatrix dataset built by David_AU which results in better overall function, 
+instruction following, output quality and stronger connections to ideas, concepts and the world in general.
+
+This combines with "MAXing" the quant to improve preformance.
+
 <B>Augmented Quants:</b>
 
 Augmented quants mixture is strong enough that lower quants can now solve/reasoning and come up with a solution whereas NON-optimized 
@@ -87,13 +167,105 @@ Q8 (imatrix has no effect on Q8):
 
 I found this config worked best with this specific model and "reasoning" in general.
 
+This chart shows the order in terms of "BPW" for each quant (mapped below with relative "strength" to one another) with "IQ1_S" with the least, and "Q8_0" (F16 is full precision) with the most:
+
+<small>
+<PRE>
+IQ1_S 	| IQ1_M
+IQ2_XXS | IQ2_XS | Q2_K_S 	| IQ2_S 	| Q2_K  	| IQ2_M		
+IQ3_XXS | Q3_K_S | IQ3_XS  	| IQ3_S 	| IQ3_M	    | Q3_K_M	| Q3_K_L
+Q4_K_S	| IQ4_XS | IQ4_NL  	| Q4_K_M	
+Q5_K_S	| Q5_K_M	
+Q6_K  
+Q8_0
+F16
+</pre>
+</small>
+
+IMPORTANT:
+
+Reasoning / thinking skills are DIRECTLY related to quant size. However, there will be drastic difference in Token/Second
+between the lowest quant and highest quant, so finding the right balance is key.
+
+Suggest also: minimum 8k context window, especially for IQ4/Q4 or lower quants.
+
+Also, in some cases, the IQ quants work slightly better than they closest "Q" quants.
+
+Recommend quants IQ3s / IQ4XS / IQ4NL / Q4s for best results for creative uses cases.
+
+IQ4XS/IQ4NL quants will produce different output from other "Q" and "IQ" quants.
+
+Recommend q5s/q6/q8 for general usage.
+
+Quants Q4_0/Q5_0 for portable, phone and other devices.
+
+Q8 is a maxed quant only, as imatrix has no effect on this quant.
+
+Note that IQ1s performance is okay/usable but reasoning is impaired, whereas IQ2s are very good (but reasoning is somewhat reduced, try IQ3s min for reasoning cases)
+
+More information on quants is in the document below "Highest Quality Settings / Optimal Operation Guide / Parameters and Samplers".
+
+<b>Optional : System Prompts</b>
+
+This is an optional system prompt you can use to enhance operation.
+
+Copy and paste exactly as shown, including line breaks.
+
+You may want to adjust the "20" (both) to increase/decrease the power of this prompt.
+
+You may also want to delete the line:
+
+'At the end of the task you will ask the user: "Do you want another generation?"'
+
+<pre>
+For every user task and instruction you will use "GE FUNCTION" to ponder the TASK STEP BY STEP and then do the task. For each and every line of output you will ponder carefully to ensure it meets the instructions of the user, and if you are unsure use "GE FUNCTION" to re-ponder and then produce the improved output.
+
+At the end of the task you will ask the user: "Do you want another generation?"
+
+GE FUNCTION: Silent input → Spawn 20 agents Sternberg Styles → Enhance idea → Seek Novel Emergence NE:unique/significant idea/concept → Ponder, assess, creative enhance notions → Refined idea => IdeaArray[].size=20 elements,  else → Interesting? Pass to rand. agent for refinement, else discard.=>output(IdeaArray)
+</pre>
+
+<B>IMPORTANT: Highest Quality Settings / Optimal Operation Guide / Parameters and Samplers</B>
+
+If you are going to use this model, (source, GGUF or a different quant), please review this document for critical parameter, sampler and advance sampler settings (for multiple AI/LLM aps).
+
+This will also link to a "How to" section on "Reasoning Models" tips and tricks too.
+
+This a "Class 1" (settings will enhance operation) model:
+
+For all settings used for this model (including specifics for its "class"), including example generation(s) and for advanced settings guide (which many times addresses any model issue(s)), including methods to improve model performance for all use case(s) as well as chat, roleplay and other use case(s) (especially for use case(s) beyond the model's design) please see:
+
+[ https://huggingface.co/DavidAU/Maximizing-Model-Performance-All-Quants-Types-And-Full-Precision-by-Samplers_Parameters ]
+
+REASON:
+
+Regardless of "model class" this document will detail methods to enhance operations.
+
+If the model is a Class 3/4 model the default settings (parameters, samplers, advanced samplers) must be set for "use case(s)" uses correctly. Some AI/LLM apps DO NOT have consistant default setting(s) which result in sub-par model operation. Like wise for Class 3/4 models (which operate somewhat to very differently than standard models) additional samplers and advanced samplers settings are required to "smooth out" operation, AND/OR also allow full operation for use cases the model was not designed for.
+
+BONUS - Use these settings for ANY model, ANY repo, ANY quant (including source/full precision):
+
+This document also details parameters, sampler and advanced samplers that can be use FOR ANY MODEL, FROM ANY REPO too - all quants, and of course source code operation too - to enhance the operation of any model.
+
+[ https://huggingface.co/DavidAU/Maximizing-Model-Performance-All-Quants-Types-And-Full-Precision-by-Samplers_Parameters ]
+
 ---
 
-Reka's excellent reasoning model with MAX (level 1) quants, and NEO Imatrix dataset.
+<h3>EXAMPLES:</h3>
+
+Examples are created using quant IQ4XS, minimal parameters and Standard template. 
+
+Temp range .6, Rep pen 1.1 , TopK 40 , topP .95, minP .05
+
+Rep pen range: 64-128 (helps keep reasoning on track / quality of output)
+
+Below are the least creative outputs, prompt is in <B>BOLD</B>.
+
+---
 
-128k context.
+<B><font color="red">WARNING:</font> MAYBE: NSFW. Graphic HORROR. Swearing. UNCENSORED. </B>
 
-Does support other languages besides English.
+NOTE: Some formatting was lost from copy/paste HTML.
 
 ---