Spark-IQ is a comprehensive educational platform that leverages artificial intelligence to enhance the learning experience for both students and educators. The platform provides intelligent assignment management, automated grading, personalized feedback, and real-time collaboration tools.
- Smart Assignment Submissions: Submit assignments in multiple formats including text, documents, and images
- AI-Powered Evaluation: Receive instant feedback and grades for your submissions
- Image Analysis: Submit artwork, diagrams, charts, and other visual content for AI evaluation
- Personalized Feedback: Get detailed, constructive feedback tailored to your work
- Progress Tracking: Monitor your academic performance with comprehensive analytics
- Real-time Chat: Connect with teachers and peers through integrated messaging
- Resource Management: Access and organize educational materials efficiently
- Intelligent Assignment Management: Create and manage assignments with AI-assisted grading
- Automated Evaluation: Save time with AI-powered assessment of student work
- Visual Content Analysis: Evaluate artwork, diagrams, and visual assignments using AI vision
- Comprehensive Analytics: Track student progress and performance metrics
- Real-time Communication: Engage with students through integrated chat features
- Resource Sharing: Distribute educational materials and announcements easily
Spark-IQ now supports advanced image analysis for assignments:
- JPG/JPEG: Standard photographic images
- PNG: High-quality images with transparency support
- GIF: Animated images and simple graphics
- WEBP: Modern web-optimized images
- Visual Composition Analysis: Evaluates design principles and artistic elements
- Technical Execution Assessment: Reviews craftsmanship and attention to detail
- Creativity Evaluation: Analyzes originality and visual communication effectiveness
- Assignment Compliance: Checks adherence to visual problem-solving requirements
- Color and Form Analysis: Evaluates use of visual elements and hierarchy
- Upload: Students can upload images up to 10MB in size
- Preview: See a preview of your image before submission
- AI Analysis: The system uses Gemini's vision capabilities to analyze visual content
- Instant Feedback: Receive detailed evaluation including strengths, areas for improvement, and actionable recommendations
- Grading: Get a numerical grade based on visual assessment criteria
- Frontend: React.js with Vite
- Backend: Node.js with Express
- Database: Firebase Firestore
- Storage: Firebase Storage
- AI Services: Google Gemini API for text and vision analysis
- Authentication: Firebase Authentication
- Styling: Tailwind CSS with custom animations
- Icons: Heroicons
- PDF files
- Microsoft Word documents (DOC, DOCX)
- Plain text files (TXT)
- Markdown files (MD)
- JPEG/JPG images
- PNG images with transparency
- GIF animated images
- WEBP modern web images
- ZIP compressed files
-
Clone the repository
git clone https://github.com/yourusername/Spark-IQ.git cd Spark-IQ -
Install dependencies
npm install
-
Environment Configuration Create a
.envfile in the root directory:VITE_GEMINI_API_KEY=your_gemini_api_key VITE_FIREBASE_API_KEY=your_firebase_api_key VITE_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com VITE_FIREBASE_PROJECT_ID=your_project_id VITE_FIREBASE_STORAGE_BUCKET=your_project.appspot.com VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id VITE_FIREBASE_APP_ID=your_app_id
-
Start the development server
npm run dev
- Login to your student account
- Browse Assignments in the assignment submission section
- Upload Files by selecting supported file types
- Submit your work for AI evaluation
- Review Feedback and grades instantly
- Track Progress through the analytics dashboard
- Login to your educator account
- Create Assignments with detailed instructions and rubrics
- Upload Resources to support student learning
- Review Submissions and AI-generated evaluations
- Provide Additional Feedback as needed
- Monitor Progress through comprehensive analytics
Spark-IQ integrates with Google's Gemini API to provide:
- Text Analysis: Comprehensive evaluation of written assignments
- Visual Analysis: Advanced image assessment for visual content
- Personalized Feedback: Tailored recommendations for improvement
- Grading Consistency: Standardized evaluation criteria across all submissions
- Student Performance Tracking: Monitor individual progress over time
- Class Analytics: View overall class performance and trends
- Assignment Insights: Analyze submission patterns and common issues
- Grade Distribution: Visual representation of class performance
- Secure Authentication: Firebase Authentication with role-based access
- Data Encryption: All data is encrypted in transit and at rest
- Privacy Protection: Student data is protected and handled according to educational privacy standards
- Access Control: Role-based permissions for students and educators
The application is configured for deployment on Vercel with the following features:
- Automatic Builds: CI/CD pipeline for seamless deployments
- Environment Management: Secure handling of environment variables
- Performance Optimization: Optimized for fast loading and smooth interactions
- Mobile Responsiveness: Fully responsive design for all devices
We welcome contributions! Please see our Contributing Guidelines for details on how to submit pull requests, report issues, and contribute to the project.
This project is licensed under the MIT License - see the LICENSE file for details.
For support and questions:
- Check our Documentation
- Open an Issue
- Contact our support team
- Advanced video analysis capabilities
- Multi-language support
- Integration with learning management systems
- Mobile app development
- Advanced analytics and reporting
- Collaborative assignment features
- Real-time collaboration tools
Spark-IQ - Empowering education through intelligent technology.