Upload 3 files

hf_space_README.md

@@ -0,0 +1,85 @@
+---
+title: CCISD TEKS Educational Assistant
+emoji: 🎓
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 4.44.0
+app_file: app.py
+pinned: false
+license: cc0-1.0
+---
+
+# 🎓 CCISD TEKS Educational Assistant
+
+An AI-powered educational assistant specialized in **Texas Essential Knowledge and Skills (TEKS)** standards, trained on 4,224 enhanced examples covering all major subject areas.
+
+## 🚀 What This Does
+
+This chat interface allows teachers, students, and educational professionals to:
+
+- **📚 Understand TEKS Standards**: Get detailed explanations of any TEKS standard
+- **👨‍🏫 Teaching Strategies**: Receive pedagogically sound teaching approaches
+- **🌎 Real-World Applications**: Discover how concepts apply to real life
+- **✅ Assessment Creation**: Generate quiz questions and evaluation criteria
+- **🎯 Learning Objectives**: Identify prerequisites and learning progressions
+- **💡 Common Misconceptions**: Address typical student misunderstandings
+
+## 🧠 Model Details
+
+- **Base Model**: [Mistral-7B-Instruct-v0.2](https://huggingface.co/mistralai/Mistral-7B-Instruct-v0.2)
+- **Fine-Tuning**: LoRA (Low-Rank Adaptation) on 4,224 CCISD TEKS examples
+- **Training Dataset**: [robworks-software/ccisd-teks-enhanced](https://huggingface.co/datasets/robworks-software/ccisd-teks-enhanced)
+- **Training Method**: 4 epochs, T4 GPU, ~6 hours
+- **Parameters**: 7B (7 billion)
+
+## 📊 Dataset Coverage
+
+The training dataset includes:
+
+- **Mathematics**: Algebra, Geometry, Statistics, Calculus
+- **Science**: Biology, Chemistry, Physics, Earth Science
+- **English/Language Arts**: Reading, Writing, Language
+- **Social Studies**: History, Geography, Economics, Government
+- **Other Subjects**: Computer Science, Fine Arts, Career & Technical Education
+
+Each example includes:
+- TEKS standard code and description
+- Detailed pedagogical explanations
+- Real-world applications
+- Teaching strategies
+- Assessment approaches
+- Common misconceptions
+- Prerequisites and learning progressions
+
+## 💻 Usage
+
+Simply type your question about Texas TEKS standards in the chat box. The model will provide detailed, accurate responses based on its training.
+
+### Example Questions:
+
+- "What is TEKS standard MATH.A1.3.B?"
+- "How should I teach the scientific method to 7th graders?"
+- "What are real-world applications of linear equations?"
+- "Create a quiz question about photosynthesis"
+- "What are common misconceptions about fractions?"
+
+## 📝 License
+
+This model and application are released under **CC0-1.0 (Public Domain Dedication)**.
+
+The underlying TEKS standards are public domain educational content from the Texas Education Agency.
+
+## 🔗 Links
+
+- **Model**: [robworks-software/ccisd-teks-educator-mistral7b](https://huggingface.co/robworks-software/ccisd-teks-educator-mistral7b)
+- **Training Dataset**: [robworks-software/ccisd-teks-enhanced](https://huggingface.co/datasets/robworks-software/ccisd-teks-enhanced)
+- **Base Model**: [mistralai/Mistral-7B-Instruct-v0.2](https://huggingface.co/mistralai/Mistral-7B-Instruct-v0.2)
+
+## ⚠️ Disclaimer
+
+This AI assistant is designed to support educational planning and understanding. While trained on authoritative TEKS standards, always verify critical information with official Texas Education Agency resources for formal curriculum planning.
+
+---
+
+**Built with**: Mistral-7B + LoRA + Enhanced CCISD TEKS Dataset

hf_space_app.py

@@ -0,0 +1,103 @@
+import gradio as gr
+from transformers import AutoModelForCausalLM, AutoTokenizer
+import torch
+
+print("🔄 Loading CCISD TEKS Educational Assistant...")
+print("   This may take 1-2 minutes on first launch...")
+
+# Load your trained model
+MODEL_NAME = "robworks-software/ccisd-teks-educator-mistral7b"
+
+tokenizer = AutoTokenizer.from_pretrained(MODEL_NAME)
+model = AutoModelForCausalLM.from_pretrained(
+    MODEL_NAME,
+    torch_dtype=torch.float16,
+    device_map="auto",
+    low_cpu_mem_usage=True
+)
+
+print("✅ Model loaded successfully!")
+
+def chat(message, history):
+    """
+    Generate response using Mistral chat format.
+
+    Args:
+        message: Current user message
+        history: List of [user_msg, bot_msg] pairs
+
+    Returns:
+        Generated response string
+    """
+
+    # Build conversation history in Mistral format
+    prompt = ""
+    for user_msg, bot_msg in history:
+        prompt += f"[INST] {user_msg} [/INST] {bot_msg}</s> "
+
+    # Add current message with system instruction
+    system_message = "You are an expert educational AI assistant specializing in Texas Essential Knowledge and Skills (TEKS) standards. Provide accurate, detailed, and pedagogically sound information to help teachers and students."
+
+    prompt += f"[INST] {system_message}\n\n{message} [/INST]"
+
+    # Tokenize
+    inputs = tokenizer(prompt, return_tensors="pt").to(model.device)
+
+    # Generate response
+    with torch.no_grad():
+        outputs = model.generate(
+            **inputs,
+            max_new_tokens=512,
+            temperature=0.7,
+            top_p=0.9,
+            do_sample=True,
+            pad_token_id=tokenizer.eos_token_id,
+            eos_token_id=tokenizer.eos_token_id,
+        )
+
+    # Decode response
+    response = tokenizer.decode(outputs[0], skip_special_tokens=True)
+
+    # Extract answer after [/INST]
+    if "[/INST]" in response:
+        response = response.split("[/INST]")[-1].strip()
+
+    return response
+
+
+# Create Gradio ChatInterface
+demo = gr.ChatInterface(
+    fn=chat,
+    title="🎓 CCISD TEKS Educational Assistant",
+    description="""
+    **Powered by Mistral-7B fine-tuned on 4,224 enhanced CCISD TEKS examples**
+
+    Ask questions about:
+    - 📚 TEKS standard definitions and explanations
+    - 👨‍🏫 Teaching strategies and lesson planning
+    - 🌎 Real-world applications
+    - ✅ Assessment and quiz generation
+    - 🎯 Learning objectives and prerequisites
+    - 💡 Common student misconceptions
+
+    *Trained on Texas TEKS standards with real-world educational data.*
+    """,
+    examples=[
+        "What is TEKS standard MATH.A1.3.B?",
+        "How should I teach the scientific method to 7th grade students?",
+        "What are real-world applications of linear equations?",
+        "Create a quiz question to assess understanding of photosynthesis",
+        "What are common misconceptions students have about fractions?",
+        "Explain ELAR.9.1.A and suggest a lesson activity",
+    ],
+    theme="soft",
+    chatbot=gr.Chatbot(height=500),
+    textbox=gr.Textbox(placeholder="Ask me about Texas TEKS standards...", container=False, scale=7),
+    retry_btn="🔄 Retry",
+    undo_btn="↩️ Undo",
+    clear_btn="🗑️ Clear",
+)
+
+# Launch the app
+if __name__ == "__main__":
+    demo.launch()

hf_space_requirements.txt

@@ -0,0 +1,6 @@
+gradio>=4.0.0
+transformers>=4.35.0
+torch>=2.0.0
+accelerate>=0.24.0
+sentencepiece>=0.1.99
+protobuf>=3.20.0