# 📊 Intelligent Diagnostic Assessment

> A revolutionary AI-powered tool to transform diagnostic educational assessment

[![Powered by Pollinations.ai](https://img.shields.io/badge/Powered%20by-Pollinations.ai-FF6B6B.svg)](https://pollinations.ai/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

### 🌸 Powered by [Pollinations AI](https://pollinations.ai/)

This project heavily leverages the **[Pollinations AI](https://pollinations.ai/)** ecosystem—an open, highly versatile platform that democratizes access to state-of-the-art Large Language Models (LLMs) and image generation models. Thanks to Pollinations AI's robust infrastructure and APIs, this application can:

- Connect directly, swiftly, and without server intermediaries to multiple leading text models (GPT, Gemini, Llama, Mistral, and more).
- Generate contextualized pedagogical illustrations in real-time with models such as *grok-imagine*, *ideogram*, and *qwen-image*.
- Deliver a tailored, interactive, and accessible educational experience to educators and students worldwide.

---

## 🎯 Overview

**Intelligent Diagnostic Assessment** is a cutting-edge web application that harnesses the power of artificial intelligence to generate personalized, interactive, and pedagogically sound diagnostic assessments. Specifically designed for educators, this tool transforms how we identify and understand students' learning needs.

## 🌟 Why This App is Critical for Education?

### 1. **Democratizing Quality Assessment**
Traditionally, creating effective diagnostic assessments requires:
- ✅ Hours of teacher work
- ✅ Expertise in instructional design
- ✅ Deep knowledge of common misconceptions
- ✅ Ability to create differentiated feedback

This application **democratizes access** to high-quality assessments, allowing any educator, regardless of experience or resources, to generate professional diagnostic instruments in minutes.

### 2. **Evidence-Based Pedagogical Approach**
The application implements proven educational principles:

- **🔴 Feedback Traffic Light**: Clear identification of mastery levels
  - 🔴 Red: Needs reinforcement / Misconception
  - 🟡 Yellow: Partial knowledge / Almost correct
  - 🟢 Green: Correct mastery / Solid prior knowledge

- **📚 Multi-Level Assessment**: Covers four critical dimensions:
  1. Prior knowledge and fundamental concepts
  2. Understanding and applied reasoning
  3. Identification of misconceptions
  4. Global diagnosis and recommendations

### 3. **Instant Personalization**
Each assessment adapts to:
- The specific topic being taught
- The evaluator teacher's level of expertise
- The particular educational context
- The diagnostic needs of the moment

### 4. **Immediate Formative Feedback**
In **formative** mode, students receive:
- Instant feedback on their responses
- Clear explanations of why an answer is correct or incorrect
- Guidance on areas that need reinforcement
- Support for self-directed learning

### 5. **Structured Summative Assessment**
In **summative** mode, teachers obtain:
- Structured data on student performance
- Precise identification of conceptual gaps
- Information to adapt instruction
- Documentation of learning progress

## 🚀 Key Features

### AI-Powered Content Generation
- **Multiple AI Models**: GPT, Gemini, Llama, Mistral, and more
- **Contextualized Questions**: Adapted to specific topic and level
- **Myth Detection**: Identifies common misconceptions
- **Differentiated Feedback**: Personalized responses based on answer level

### Customizable Visual Experience
- **🎨 10 Color Palettes**: From Oceanic to Steel Blue
- **🎭 20 Visual Styles**: Modern, Educational, Playful, Scientific, and more
- **🌓 Dark/Light Mode**: Adaptable visual comfort
- **📱 Responsive Design**: Works on any device

### Rich Content Integration
- **🖼️ Image Generation**: Support for multiple models (grok-imagine, ideogram, qwen-image)
- **∑ MathJax Support**: Professional mathematical notation
- **📊 Interactive Visualization**: Animated diagnostic traffic light

### Assessment Modes
- **📧 Summative**: Email submission of results
- **💡 Formative**: Immediate and interactive feedback

### Multilingual
- **🌐 Spanish and English**: Fully translated interface and content
- **Dynamic Switching**: Toggle between languages without losing progress

### Flexible Export
- **💾 HTML Download**: Save assessments for offline use
- **📄 Word Download**: Compatible with word processors

## 🎓 Educational Impact

### For Teachers
✅ **Time Savings**: From hours to minutes in assessment creation  
✅ **Professional Quality**: Pedagogically sound instruments  
✅ **Adaptability**: Customization for any topic or level  
✅ **Actionable Data**: Clear information to guide instruction  
✅ **Continuous Update**: Access to latest AI models

### For Students
✅ **Personalized Learning**: Feedback adapted to their level  
✅ **Metacognition**: Understanding their own strengths and weaknesses  
✅ **Autonomy**: Tools for self-directed learning  
✅ **Motivation**: Constructive and growth-oriented feedback  
✅ **Accessibility**: Clear interface and multiple learning styles

### For Educational Institutions
✅ **Standardization**: Consistent and quality assessments  
✅ **Scalability**: Implementation across multiple levels and areas  
✅ **Gap Analysis**: Systematic identification of needs  
✅ **Pedagogical Innovation**: Adoption of advanced educational technologies  
✅ **Cost-Effectiveness**: Free professional-level tool

## 🔧 Installation and Usage

### Prerequisites
- Modern web browser (Chrome, Firefox, Safari, Edge)
- Pollinations AI API Key ([Get it here](https://enter.pollinations.ai/))

### Installation
```bash
# Clone the repository
git clone https://github.com/your-username/diagnostic-assessment.git

# Navigate to directory
cd diagnostic-assessment

# Open in browser
# Simply open index.html in your favorite browser
```

### Quick Start

1. **Initial Setup**
   - Open `index.html` in your browser
   - Click "Get API Key" to obtain your Pollinations AI key
   - Paste your API Key in the corresponding field

2. **Create an Assessment**
   - Select your preferred language (🌐 Español/English)
   - Enter the evaluator expert (e.g., "mathematics", "biology")
   - Enter the topic to evaluate (e.g., "Photosynthesis", "Quadratic equations")
   - Select the test type (Summative or Formative)
   - Customize colors, visual style, and AI models
   - Click "🚀 Generate diagnostic assessment"

3. **Use the Assessment**
   - **Formative Mode**: Students answer and receive immediate feedback
   - **Summative Mode**: Students complete and submit via email to teacher

4. **Export**
   - Download as HTML for offline use
   - Download as Word for additional editing

## 🎨 Customization

### Color Palettes
- Oceanic (default)
- Sunset
- Forest
- Royal Purple
- Crimson Night
- Golden Sands
- Minty Fresh
- Graphite Lime
- Rose Quartz
- Steel Blue

### Visual Styles
- Default
- Modern
- Corporate
- Creative
- Minimalist
- Glassmorphism
- Dark Neon
- Brutalist
- Vibrant Gradient
- Editorial / Magazine
- Terminal / Tech
- Colorful Infographic
- Retro / Vintage
- Pastel Brutalist
- Cyberpunk
- Ecological / Organic
- Dark Noir
- **Educational / Academic** ⭐
- **Playful / Fun** ⭐
- **Scientific / Lab** ⭐

### Available AI Models

**Text:**
- GPT 5.4 Nano (default)
- GPT 5.4 Mini
- Gemini 2.5 Flash
- Gemini Flash Lite 3.5
- Gemini 2.5 Search
- Llama 3.3 70B
- Llama 4 Scout
- Mistral Small 4
- And more...

**Images:**
- grok-imagine
- ideogram-v4-turbo
- qwen-image
- And more...

## 📖 Educational Use Cases

### 1. Primary Education
```
Topic: "Vertebrate animals"
Expert: "natural sciences"
Style: Playful / Fun
Type: Formative (immediate feedback)
```

### 2. Secondary Education
```
Topic: "Second degree equations"
Expert: "mathematics, algebra"
Style: Educational / Academic
Type: Summative (email submission)
Include: MathJax enabled
```

### 3. Higher Education
```
Topic: "Thermodynamics: First Law"
Expert: "physics, thermodynamics"
Style: Scientific / Lab
Type: Formative
Include: MathJax enabled + Images
```

### 4. Professional Training
```
Topic: "React Fundamentals"
Expert: "web development, programming"
Style: Terminal / Tech
Type: Summative
```

## 🔒 Privacy and Security

- ✅ **No Data Storage**: Data is not saved on servers
- ✅ **Local Processing**: Interface works entirely in browser
- ✅ **Private API Key**: Stored locally in your browser
- ✅ **Open Source**: Full code transparency
- ✅ **No Tracking**: No usage data collected

## 🤝 Contributions

Contributions are welcome and appreciated. To contribute:

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/NewFeature`)
3. Commit your changes (`git commit -m 'Add new feature'`)
4. Push to the branch (`git push origin feature/NewFeature`)
5. Open a Pull Request

## 📝 License

This project is under the MIT License. See the [LICENSE](LICENSE) file for more details.

## 👨‍💻 Author

**Juan Guillermo Rivera Berrío**

Designed with ❤️ for educators and students worldwide.

Developed with:
- DeepSeek V4 Technology
- Open Code Assistance
- Pollinations AI for content generation

## 🙏 Acknowledgments

- To all educators who inspire better pedagogical tools
- To the open-source community for the libraries used
- To AI model developers who make this technology possible
- To students who are at the center of every educational process

## 📧 Contact and Support

Questions? Suggestions? Need help?

- 📫 [Create an Issue](https://github.com/your-username/diagnostic-assessment/issues)
- 💬 [Start a Discussion](https://github.com/your-username/diagnostic-assessment/discussions)

---

**⭐ If you find this tool useful, consider giving it a star on GitHub to support the project.**

---

## 🔮 Future Roadmap

- [ ] LMS Integration (Moodle, Canvas, Google Classroom)
- [ ] Analytics and dashboard for teachers
- [ ] Reusable question bank
- [ ] Peer collaborative assessment
- [ ] Support for more languages (French, German, Portuguese)
- [ ] Full offline mode with PWA
- [ ] SCORM export
- [ ] School management system integration

---

**Let's transform education together, one assessment at a time.** 🎓✨