Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,88 @@
+---
+language:
+- en
+license: llama3.1
+library_name: llama-cpp
+base_model: mohdAlal1/Nafha-Llama3.1-8B-Perfumery-Expert-v1
+tags:
+- llama
+- llama-3.1
+- gguf
+- quantized
+- perfumery
+- fragrance
+- neuroscent
+- nafha
+model_name: Nafha-Llama3.1-8B-Perfumery-Expert-v1-GGUF
+---
+
+# Nafha-Llama3.1-8B-Perfumery-Expert-v1-GGUF
+
+GGUF quantized versions of [mohdAlal1/Nafha-Llama3.1-8B-Perfumery-Expert-v1](https://huggingface.co/mohdAlal1/Nafha-Llama3.1-8B-Perfumery-Expert-v1) — a fine-tuned Llama 3.1 8B Instruct model specialized in perfumery and fragrance science.
+
+## About the Model
+
+**Nafha-Expert** is the AI core of the **NeuroScent** project — a system that combines AI, machine learning, and hardware to create personalized perfumes. The model was fine-tuned using QLoRA (r=16) on Meta Llama 3.1 8B Instruct with a curated dataset of ~16,400 perfumery Q&A pairs generated from 35 professional perfumery texts.
+
+The model has deep knowledge of:
+- **Ingredient Chemistry** — aroma chemicals, natural materials, usage rates, safety
+- **Accord Building** — how to combine materials into harmonious accords
+- **Fragrance Pyramid Architecture** — top, middle, and base note theory
+- **Formula Generation** — structured perfume formula creation (NeuroComposer mode)
+
+## Available Quantizations
+
+| Filename | Quantization | Size | Description |
+|---|---|---|---|
+| `Nafha-Llama3.1-8B-Perfumery-Expert-v1.Q4_K_M.gguf` | Q4_K_M | ~4.9 GB | Most popular — best for 8GB VRAM GPUs |
+| `Nafha-Llama3.1-8B-Perfumery-Expert-v1.Q5_K_M.gguf` | Q5_K_M | ~5.7 GB | Great balance of quality and size |
+| `Nafha-Llama3.1-8B-Perfumery-Expert-v1.Q8_0.gguf` | Q8_0 | ~8.5 GB | Highest quality quantization |
+| `Nafha-Llama3.1-8B-Perfumery-Expert-v1.f16.gguf` | F16 | ~16 GB | Full precision GGUF (reference) |
+
+## How to Use
+
+### With Ollama
+
+Create a `Modelfile`:
+```
+FROM ./Nafha-Llama3.1-8B-Perfumery-Expert-v1.Q4_K_M.gguf
+
+TEMPLATE """<|begin_of_text|><|start_header_id|>system<|end_header_id|>
+{{ .System }}<|eot_id|><|start_header_id|>user<|end_header_id|>
+{{ .Prompt }}<|eot_id|><|start_header_id|>assistant<|end_header_id|>
+"""
+
+SYSTEM "You are Nafha, an expert perfumer AI with deep knowledge of fragrance chemistry, ingredient science, and perfume composition."
+
+PARAMETER temperature 0.7
+PARAMETER top_p 0.9
+```
+
+Then run:
+```bash
+ollama create nafha-expert -f Modelfile
+ollama run nafha-expert "Explain the role of Hedione in modern perfumery."
+```
+
+### With llama.cpp
+
+```bash
+./llama-cli -m Nafha-Llama3.1-8B-Perfumery-Expert-v1.Q4_K_M.gguf \
+  -p "Explain the difference between a fougère and a chypre accord." \
+  -n 512 --temp 0.7
+```
+
+### With LM Studio / Jan / Open WebUI
+
+Download any of the GGUF files above and load them directly in your preferred UI.
+
+## Original Model
+
+- **Source:** [mohdAlal1/Nafha-Llama3.1-8B-Perfumery-Expert-v1](https://huggingface.co/mohdAlal1/Nafha-Llama3.1-8B-Perfumery-Expert-v1)
+- **Base:** Meta Llama 3.1 8B Instruct
+- **Training:** QLoRA (r=16) with Unsloth + TRL SFTTrainer
+- **Dataset:** [mohdAlal1/neuroscent-nafha-training-public](https://huggingface.co/datasets/mohdAlal1/neuroscent-nafha-training-public)
+
+## Part of NeuroScent
+
+This model is a component of the **NeuroScent** senior project — where neuroscience meets olfaction. The full system analyzes user psychology and preferences, maps them to a custom fragrance formula via an ML regression model, and physically dispenses the perfume through automated hardware.