📚 Rural Education AI Tutor

An AI-powered personalized learning platform designed to provide quality education to rural students, focusing on SDG 4: Quality Education. This application uses Google's Gemini AI to generate personalized lessons and quizzes based on the student's age, subject of interest, and skill level.

🌟 Features

• Personalized Learning: Custom lessons based on student's age, subject, and skill level
• Interactive Quizzes: AI-generated quizzes to test understanding
• Progress Tracking: Save and track learning progress over time
• Mobile-Friendly: Responsive design works on all devices
• Multilingual Support: Option to translate lessons into different languages
• Voice Input: Answer quiz questions using voice (optional)
• Certificates: Generate certificates upon completing topics

🚀 Getting Started

Prerequisites

• Python 3.8 or higher
• A Google Gemini API key (get it from Google AI Studio)

Installation

1. Clone the repository:

   git clone <repository-url>
   cd student-ai-agent

2. Create a virtual environment (recommended):

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install the required packages:

   pip install -r requirements.txt

4. Set up your environment variables:

   • Copy the .env.example file to .env
   • Add your Gemini API key to the .env file

Running the Application

1. Start the Streamlit app:

   streamlit run app.py

2. Open your web browser and navigate to http://localhost:8501

🛠️ Project Structure

• app.py: Main Streamlit application
• gemini_agent.py: Handles interactions with the Gemini AI
• data_handler.py: Manages user data and progress tracking
• requirements.txt: Lists all Python dependencies
• .env: Stores environment variables (API keys, etc.)

🌐 Usage

1. Welcome Page: Enter your name, age, subject of interest, and skill level
2. Lesson Page: Study the AI-generated lesson
3. Quiz Page: Test your understanding with interactive quizzes
4. Feedback Page: View your results and track your progress

📊 Data Privacy

All user data is stored locally in the user_data directory. No personal information is sent to external servers except for the Gemini API for lesson and quiz generation.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Google Gemini AI for the powerful language model
• Streamlit for the easy-to-use web framework
• All open-source contributors

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

Made with ❤️ for quality education