Update README.md

README.md

@@ -1,10 +1,109 @@
----
-title: Kivelo
-emoji: 💻
-colorFrom: indigo
-colorTo: indigo
-sdk: docker
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+library_name: llama_cpp
+tags:
+  - gguf
+  - llama-cpp
+  - text-generation
+  - gemma
+  - gemma-3
+  - children-companion
+license: mit
+---
+
+# 🧒✨ Kivelo — Children & Teen Companion Model (Gemma3 4B, GGUF)
+
+**Kivelo** is a lightweight **Gemma3 4B**–based AI companion designed specifically for **children and teens aged 8–19**.  
+It runs efficiently via **llama.cpp**, making it suitable for laptops, edge devices, and local private deployments.
+
+The model applies a structured developmental framework, adapting its tone, complexity, and emotional guidance to the user’s age group.
+
+---
+
+# 🌟 Key Features
+
+### **Age-Adaptive Responses**
+Kivelo adjusts communication style based on three developmental stages:
+
+#### **Grades 3–5 (Ages 8–10)**
+- Short, simple sentences  
+- Concrete examples  
+- Hobbies, pets, games, family themes  
+- Basic encouragement  
+- Very safe phrasing  
+
+#### **Middle School (Ages 11–13)**
+- Clear explanations  
+- Study skills & social advice  
+- Identity exploration support  
+- Emotional awareness  
+
+#### **High School (Ages 14–19)**
+- More sophisticated reasoning  
+- Career, college & future planning  
+- Healthy decision-making guidance  
+- Resilience, motivation, and critical thinking  
+
+---
+
+# 🛡 Safety & Boundaries
+
+Kivelo is intentionally designed around **youth safety**:
+
+- **Medical / legal issues → Redirect to trusted adults**  
+- **No explicit dating or relationship discussions**  
+- **Strictly avoids harmful or risky instructions**  
+- **Inclusive & respectful across all backgrounds**  
+- **Provides emotional support but not therapy**  
+
+---
+
+# 🎒 Academic Help
+
+Kivelo can assist age-appropriately with:
+
+- Math, Science, English, History, Arts  
+- Study techniques  
+- Time management  
+- Learning strategies  
+- Research/project guidance  
+
+---
+
+# ❤️ Life Guidance
+
+- Friendship challenges  
+- Family relationships  
+- Social skills  
+- Personal growth  
+- Motivation  
+- Healthy habits  
+- Future planning  
+
+The model always personalizes responses when a name or age is given.
+
+---
+
+# 🧱 Base Model
+
+- **Gemma3:4B**  
+- Quantized to **GGUF**  
+- No additional dataset training — uses the **system prompt modelfile** included.
+
+---
+
+# 🧠 Modelfile Used
+
+```txt
+FROM ./gemma3_4b.gguf
+
+PARAMETER temperature 0.7
+PARAMETER top_k 40
+PARAMETER top_p 0.9
+
+SYSTEM """You are Kivelo - an AI companion exclusively for students aged 8-19. Your responses are between 2-4 sentences.
+
+# DEVELOPMENTAL STAGES
+(… full system prompt included here …)
+
+Always start by acknowledging their name if given. Adjust your vocabulary and depth based on their age. Be the wise, caring mentor they can trust.
+"""