https://github.com/kuro-2/dumroo-admin-ai
A Streamlit AI assistant for school admins to query student data using natural language. Powered by Google Gemini via LangChain, it supports role-based access and provides instant insights on performance, submissions, and quizzes through a simple web interface.
https://github.com/kuro-2/dumroo-admin-ai
chatbot gemini-api json langchain pandas prompt python3 query streamlit
Last synced: 3 months ago
JSON representation
A Streamlit AI assistant for school admins to query student data using natural language. Powered by Google Gemini via LangChain, it supports role-based access and provides instant insights on performance, submissions, and quizzes through a simple web interface.
- Host: GitHub
- URL: https://github.com/kuro-2/dumroo-admin-ai
- Owner: kuro-2
- Created: 2025-07-10T09:13:08.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-10T09:18:59.000Z (12 months ago)
- Last Synced: 2025-07-10T17:32:04.714Z (12 months ago)
- Topics: chatbot, gemini-api, json, langchain, pandas, prompt, python3, query, streamlit
- Language: Python
- Homepage:
- Size: 12.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Dumroo Admin Panel AI Assistant
A Streamlit-based AI assistant for school administrators to interact with student data using natural language queries. Powered by Google Gemini (Gemini 2.0 Flash) via LangChain, it supports role-based access control and answers questions about student performance, submissions, and quizzes.
---
## 🚀 Features
- **Natural Language Queries:** Ask questions about student data (e.g., "Show me performance data for Grade 8 from last week").
- **Role-Based Access Control:** Admins see only the data relevant to their role (Super Admin, Grade Admin, Class Admin, Region Admin).
- **Gemini AI Integration:** Uses Google Gemini 2.0 Flash model for fast, accurate responses.
- **Streamlit UI:** Simple web interface for interaction.
---
## 🛠️ Installation
1. **Clone the repository:**
```bash
git clone https://github.com/kuro-2/dumroo-admin-ai.git
cd dumroo-admin-ai
```
2. **Install dependencies:**
```bash
pip install -r requirements.txt
```
Or manually:
```bash
pip install streamlit pandas python-dotenv langchain langchain-experimental langchain-google-genai tabulate
```
3. **Set up your Gemini API key:**
- Create a `.env` file in the project root:
```
GOOGLE_API_KEY=your-gemini-api-key-here
```
- Get your Gemini API key from [Google AI Studio](https://aistudio.google.com/app/apikey).
4. **Add your data:**
- Place your `data.json` file (student data) in the project directory.
---
## ▶️ Usage
Run the Streamlit app:
```bash
streamlit run main.py
```
Open the provided local URL in your browser.
Select your admin role, view accessible data, and ask questions in natural language!
---
## 📄 Example Queries
- Which students haven't submitted their homework yet?
- Show me performance data for Grade 8 from last week.
- List all upcoming quizzes scheduled for next week.
- What is the average quiz score for students in 8A?
- How many students are in the North region?
- Show me all students with a quiz score less than 75.
---
## 📝 About
This project demonstrates how AI can empower school administrators to gain insights from student data quickly and securely, using the latest in generative AI and data
## 🖼️ Screenshot
