Update README.md

README.md

@@ -1,49 +1,80 @@
 ---
 base_model: unsloth/meta-llama-3.1-8b-instruct-unsloth-bnb-4bit
 tags:
-- text-generation-inference
-- transformers
-- unsloth
-- llama
-- gguf
+  - text-generation-inference
+  - transformers
+  - llama
+  - gguf
 license: apache-2.0
 language:
-- en
+  - en
 ---
 
-# NASA Systems Engineering LLaMA-3.1 8B Instruct (Fine-Tuned)
+# 🚀 NASA Systems Engineering LLaMA-3.1 8B Instruct (Fine-Tuned)
 
-- **Developed by:** MarshallDoyle  
-- **License:** Apache-2.0  
-- **Fine-tuned from model:** unsloth/meta-llama-3.1-8b-instruct-unsloth-bnb-4bit  
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)  
+[![Parameters](https://img.shields.io/badge/Parameters-8.1B%20total%20(%2B83.8M%20LoRA)-lightgrey.svg)]()  
+[![Context Window](https://img.shields.io/badge/Context%20Window-128K%20tokens-lightgrey.svg)]()
 
-This model specializes in answering questions and summarizing content from NASA’s *Systems Engineering Handbook* (2018) PDF. It was fine-tuned using Hugging Face’s TRL and LoRA techniques for high efficiency.
+![NASA SE Handbook Preview](https://www.nasa.gov/sites/default/files/atoms/files/nasa_systems_engineering_handbook_0.pdf#page=1)
 
-## Preview of Fine-Tuning Source
+**Developed by:** MarshallDoyle  
+**Fine-tuned from:** `unsloth/meta-llama-3.1-8b-instruct-unsloth-bnb-4bit`  
+**Specialization:** NASA *Systems Engineering Handbook* (2018) Q&A  
+**Training recipe:** LoRA rank=16, epochs=3, steps=285, final loss≈0.40–0.60
 
-![Preview of NASA Systems Engineering Handbook first page](https://www.nasa.gov/sites/default/files/atoms/files/nasa_systems_engineering_handbook_0.pdf#page=1)
+---
+
+## ✨ Key Features
 
-*(Above: the front page of the NASA Systems Engineering Handbook used for fine-tuning.)*
+| Feature               | Details                                                |
+|-----------------------|--------------------------------------------------------|
+| **Domain Expertise**  | Deep knowledge of NASA SE lifecycle, terminology, and best practices.  |
+| **Compact Footprint** | +83.8M trainable via LoRA on 8B base.                 |
+| **Long Context**      | Up to 128K token support for large documents.          |
+| **Fast Inference**    | Efficient TRL & Unsloth pipeline.                       |
 
 ---
 
-## Overview
+## 🎯 Intended Use Cases
+
+- **Interactive Q&A:** Rapid lookup of definitions, processes, and phase purposes.
+- **Summarization:** Concise overviews of complex sections in the handbook.
+- **Educational Tools:** Training aids for systems engineering students and professionals.
+- **Mission Planning:** Quick reference for verification, validation, and lifecycle checkpoints.
+
+---
+
+## 📊 Example Comparisons
+
+<details>
+<summary><strong>Phase C Purpose</strong></summary>
+
+| Model             | Response Snippet                                                                                                                                                         |
+|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Base LLaMA-3.1**| _“Phase C covers detailed design and preparations for manufacturing…”_ (generic)                                                                                          |
+| **Fine-Tuned**    | _“The main purpose is to complete the detailed design of system elements, fabricate hardware, and code software, ensuring all end products are defined for integration.”_  |
+
+</details>
 
-**Key Features:**
+<details>
+<summary><strong>Verification vs. Validation</strong></summary>
 
-- **Domain Expertise:** Deep understanding of NASA systems engineering lifecycle phases, verification vs. validation testing, and SE best practices.  
-- **Compact Footprint:** Keeps the lightweight 8B base model, adding only ~83.8M trainable parameters via LoRA.  
-- **Extended Context:** Supports up to 128K tokens for long-form document Q&A.  
+| Model             | Response Snippet                                                                                                                                                          |
+|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Base LLaMA-3.1**| _“Verification checks requirements; validation checks user needs…”_ (too brief)                                                                                            |
+| **Fine-Tuned**    | _“Verification ensures the system meets specified requirements; validation confirms it satisfies stakeholder expectations in its intended environment.”_                     |
 
-**Intended Use:** Ideal for educational tools, engineering Q&A assistants, mission planning support, and rapid handbook lookup.
+</details>
 
 ---
 
-## Model Card Updates
+## ⚠️ Limitations
 
-- Removed Unsloth branding badges in favor of a direct preview of the NASA PDF source.  
-- Added a representative image of the handbook’s first page to illustrate the training data.
+- **Scope Bounded:** Content based on the 2018 handbook; may omit newer updates.
+- **Hallucinations:** Possible on out-of-handbook queries.
+- **Bias:** NASA-specific terminology; verify critical engineering decisions against official documents.
 
 ---
 
-*
+🔗 **Download & Details:** [Hugging Face model page](https://huggingface.co/MarshallDoyle/NASA-Systems-Engineering)