Update README.md

README.md

@@ -3,16 +3,95 @@ tags:
 - gguf
 - llama.cpp
 - unsloth
-
+- text-generation-inference
+license: mit
+language:
+- en
+base_model:
+- microsoft/Phi-3.5-mini-instruct
+pipeline_tag: text-generation
 ---
+# Version 2.0: The "Native JSON" Update
+The model has been completely re-trained from the ground up to be more stable, expressive, and structurally sound.
+## What's New in V2?
+While V1 was successfully fine-tuned to repond in JSON format, it required a System Prompt to guide the model for that behavior. V2 has been deeply trained (455 steps, 0.39 loss) to make JSON and the personality its native language. It now understands the JSON structure at a foundational level, making it more 'alive,' talkative, and responsive even with minimal prompting.
+If you are downloading the new version, you can still use your old Modelfile! However, you will notice that responses feels much more talkative and emotional because the model is deeply fine-tuned.
+
+- For Ollama users A Modelfile is added for you to get the best results out of the model(RECOMMENDED).
+### Disclaimer
+- Modelfile is only for guiding the LLM to always respond in structured way without rambling or generating tokens endlessly, the structure of response and personality is all came from true fine-tuning.
 
 # phi-3.5-AI-Vtuber-json : GGUF
 
-This model was finetuned and converted to GGUF format using [Unsloth](https://github.com/unslothai/unsloth).
+This  is a fine-tuned large language model based on Phi-3.5 Mini-Instruct, optimized for AI companion applications that require strict, machine-readable JSON output.
+
+This was trained to always return responses in a consistent JSON format with response and emotion fields. This makes it easy to integrate with software that parses and uses AI outputs programmatically.
+
+🔗 Project Nova, where i have used this model: https://github.com/Navjot-Singh7/Project-Nova
+___
+## Model Overview
+* **Base Model: Phi-3.5 Mini-Instruct**
+* **Fine-Tuned For: AI companion behavior with structured JSON output**
+Output Format:
+```bash
+{
+  "response": "...",
+  "emotion": "..."
+}
+```
+Primary Use Case: AI companion systems and applications where responses must be machine-readable.
+___
+## Capabilities
+
+- This model has been fine-tuned to:
+
+  - Generate companion-style text that is appropriate, engaging, and in JSON format.
+
+  - Always include both:
+
+    - response: the AI’s text output
+
+    - emotion: a tag describing the emotional tone of the response
+
+Produce outputs that are consistent and reliable for code integration.
+___
+## Intended Use
+#### Primary Use Cases
+- AI companion applications
+- Virtual characters or avatars
+- VTuber or assistant personalities
+-Applications that require structured LLM output
+- Emotion-aware conversational systems
+___
+
+## Training Details
+
+**Custom Dataset -**
+I created my own labeled dataset with 10–20 original samples with JSON-style examples.
+
+**Synthetic Data Generation -**
+Then I expanded this initial dataset using another language model to create a synthetic training corpus of ~1,800 samples.
+
+**Fine-Tuning Environment -**
+Training was performed using Google Colab.
+
+**Dataset Composition -**
+The dataset contains structured examples that guide the model to generate JSON output with response and emotion.
+___
+## Usage Example
+Below is an example of how the model might respond in your application:
+```bash
+{
+  "response": "Hello! I'm fine thank you... uhm.. did you have a good day?", 
+  "emotion": "happy"
+}
+```
+This makes it easy to parse and handle both the semantic content (response) and the emotional context (emotion) in code.
+___
+## License
 
-**Example usage**:
-- For text only LLMs:    `llama-cli -hf Navpy/phi-3.5-AI-Vtuber-json --jinja`
-- For multimodal models: `llama-mtmd-cli -hf Navpy/phi-3.5-AI-Vtuber-json --jinja`
+This model is licensed under the MIT License.
+You are free to use, modify, and distribute this model for personal or educational purposes.
 
 ## Available Model files:
 - `phi-3.5-mini-instruct.Q4_K_M.gguf`
@@ -20,4 +99,4 @@ This model was finetuned and converted to GGUF format using [Unsloth](https://gi
 ## Ollama
 An Ollama Modelfile is included for easy deployment.
 This was trained 2x faster with [Unsloth](https://github.com/unslothai/unsloth)
-[<img src="https://raw.githubusercontent.com/unslothai/unsloth/main/images/unsloth%20made%20with%20love.png" width="200"/>](https://github.com/unslothai/unsloth)
+[<img src="https://raw.githubusercontent.com/unslothai/unsloth/main/images/unsloth%20made%20with%20love.png" width="200"/>](https://github.com/unslothai/unsloth)