shiksha-ai

KO | EN

gitlite — search

#python #react #golang #machine-learning #deep-learning #linux #docker #java #windows #awesome #cli #security #mcp #openai

(★ 9)

AI-powered teaching assistant for educators in low-resource environments. Automates lesson planning, content creation & more.

shiksha-ai Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![GitHub deployments](https://img.shields.io/github/deployments/skully-coder/shiksha-ai/production?style=for-the-badge&label=deployment)

# 🎓 Shiksha AI — AI-Powered Teaching Assistant

> Empowering educators with intelligent tools to simplify teaching in low-resource environments.

---

## 🧠 Overview

**Shiksha AI** is an **AI-powered teaching assistant** designed to support educators in developing regions.  
It helps automate repetitive tasks like lesson planning, assessment generation, and resource creation — making education more effective and accessible.

---

## 💡 Problem Statement

Teachers in developing regions often face challenges such as:

- ⏱️ Heavy workloads and time constraints  
- 📚 Limited access to quality teaching resources  
- 🌍 Multilingual and diverse classrooms  
- 🧩 Need for customized and inclusive learning materials

**Shiksha AI** solves these issues by offering instant, AI-driven tools that save time, enhance productivity, and improve teaching quality.

---

## ⚙️ Tech Stack

| Layer | Technology Used |
|-------|------------------|
| **Frontend** | Next.js, React |
| **Styling** | ShadCN UI, Tailwind CSS |
| **Backend** | Firebase |
| **AI Integration** | Genkit with Google Gemini Models |
| **Theme Management** | next-themes |

Built for **scalability**, **ease of use**, and **performance**.

---

## 📊 ShikshaAI Architecture

- [High-Level Diagram](https://app.diagrams.net/?url=https://raw.githubusercontent.com/skully-coder/shiksha-ai/refs/heads/master/ShikshaAI-Architecture.drawio)
- [Use Case Diagram](https://app.diagrams.net/?url=https://raw.githubusercontent.com/skully-coder/shiksha-ai/refs/heads/master/ShikshaAI-UseCase.drawio)

---

## 🌙 Theme Switcher

Shiksha AI includes a **dynamic theme switcher** that enhances user experience by providing both light and dark mode options.

**Workflow**: Click theme button → Instant toggle → Auto-saved preference → Applied across all pages

---

## 🌍 Impact

Shiksha AI contributes to a more equitable education ecosystem by:

- 💪 Boosting teacher efficiency and creativity  
- 🧾 Providing personalized lesson plans and materials  
- 🌐 Bridging the digital divide in low-connectivity regions  
- 👩‍🏫 Allowing teachers to focus more on student interaction  
- 🌙 Offering comfortable viewing experience in any lighting condition

---

## 🧪 Admin Console (Development Mode)

An internal **Admin Console** allows developers to quickly test and manage users during development without full authentication flow.

### 🚀 How to Use

1. Run the app in development mode:
   ```bash
   npm run dev
   ```

2. Open in browser:
   ```bash
   http://localhost:3000/admin
   ```

### ✅ Supported Features

- Add new generated users manually  
- Bypass authentication for faster testing  
- Assign roles (e.g., **Student**, **Teacher**, **Admin**)  
- Simulate various access levels

> ⚠️ **Important:** Never enable the Admin Console in production. Always disable or remove this route before public deployment.

---

## 🤝 Contribution Guidelines

We welcome contributions!  
Please see our [Contribution Guidelines](/CONTRIBUTING.md) before making a pull request.

---

## 📊 Project Stats

![GitHub commit activity](https://img.shields.io/github/commit-activity/w/skully-coder/shiksha-ai?style=for-the-badge)
![GitHub contributors](https://img.shields.io/github/contributors/skully-coder/shiksha-ai?style=for-the-badge&cacheSeconds=3600)
![GitHub PRs](https://img.shields.io/github/issues-pr/skully-coder/shiksha-ai?style=for-the-badge&color=purple)
![GitHub PRs Closed](https://img.shields.io/github/issues-pr-closed/skully-coder/shiksha-ai?style=for-the-badge&color=green)
![GitHub Issues](https://img.shields.io/github/issues/skully-coder/shiksha-ai?style=for-the-badge)
[![Issues Resolved](https://img.shields.io/badge/Issues%20Resolved-2-orange?style=for-the-badge)](https://github.com/skully-coder/shiksha-ai/issues?q=is%3Aissue%20state%3Aclosed)
[![GitHub Forks](https://img.shields.io/github/forks/skully-coder/shiksha-ai?style=for-the-badge&color=brightgreen)](https://github.com/skully-coder/shiksha-ai/network/members)
[![GitHub Stars](https://img.shields.io/github/stars/skully-coder/shiksha-ai?style=for-the-badge&color=yellow)](https://github.com/skully-coder/shiksha-ai/stargazers)
[![Hacktoberfest Participation](https://img.shields.io/badge/Hacktoberfest-2025-blueviolet?style=for-the-badge&logo=hacktoberfest)](https://hacktoberfest.com)

---

## 👥 Contributors

<table>
	<tbody>
		<tr>
 <td align="center">
 <a href="https://github.com/skully-coder">
 <img src="https://avatars.githubusercontent.com/u/55917548?v=4" width="100;" alt="skully-coder"/>
 
 Abhinav Agrawal
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/madhurchouhan7">
 <img src="https://avatars.githubusercontent.com/u/30585596?v=4" width="100;" alt="madhurchouhan7"/>
 
 Madhur
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/PTejass">
 <img src="https://avatars.githubusercontent.com/u/144028081?v=4" width="100;" alt="PTejass"/>
 
 P B TEJAS
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/prajeeta15">
 <img src="https://avatars.githubusercontent.com/u/96904203?v=4" width="100;" alt="prajeeta15"/>
 
 Prajeeta
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/DCode-v05">
 <img src="https://avatars.githubusercontent.com/u/182192643?v=4" width="100;" alt="DCode-v05"/>
 
 Denistan B
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/poorna825">
 <img src="https://avatars.githubusercontent.com/u/214160404?v=4" width="100;" alt="poorna825"/>
 
 Poornima Taley
 </a>
 </td>
		</tr>
		<tr>
 <td align="center">
 <a href="https://github.com/its-Pratik-15">
 <img src="https://avatars.githubusercontent.com/u/182534401?v=4" width="100;" alt="its-Pratik-15"/>
 
 Pratik Kumar Pan
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/Z33xD">
 <img src="https://avatars.githubusercontent.com/u/79450902?v=4" width="100;" alt="Z33xD"/>
 
 Zeeshan
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/Denistanb05">
 <img src="https://avatars.githubusercontent.com/u/214665212?v=4" width="100;" alt="Denistanb05"/>
 
 Denistan B
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/Sidratul02">
 <img src="https://avatars.githubusercontent.com/u/142794200?v=4" width="100;" alt="Sidratul02"/>
 
 Sidratul Muntaha
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/pipaliyajaydip">
 <img src="https://avatars.githubusercontent.com/u/67597366?v=4" width="100;" alt="pipaliyajaydip"/>
 
 Jaydip Pipaliya
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/Dhanwantisatone">
 <img src="https://avatars.githubusercontent.com/u/191073548?v=4" width="100;" alt="Dhanwantisatone"/>
 
 Dhanwantisatone
 </a>
 </td>
		</tr>
		<tr>
 <td align="center">
 <a href="https://github.com/Abinesh2418">
 <img src="https://avatars.githubusercontent.com/u/183372764?v=4" width="100;" alt="Abinesh2418"/>
 
 Abinesh B
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/abbasabro">
 <img src="https://avatars.githubusercontent.com/u/141827555?v=4" width="100;" alt="abbasabro"/>
 
 Abbas Abro
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/Aditya-Bajpayee007">
 <img src="https://avatars.githubusercontent.com/u/145580411?v=4" width="100;" alt="Aditya-Bajpayee007"/>
 
 Aditya Bajpayee
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/notAryan10">
 <img src="https://avatars.githubusercontent.com/u/184558940?v=4" width="100;" alt="notAryan10"/>
 
 Aryan Verma
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/ImgBotApp">
 <img src="https://avatars.githubusercontent.com/u/31427850?v=4" width="100;" alt="ImgBotApp"/>
 
 Imgbot
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/MarioDevTM">
 <img src="https://avatars.githubusercontent.com/u/84230374?v=4" width="100;" alt="MarioDevTM"/>
 
 Mario Turtoi
 </a>
 </td>
		</tr>
		<tr>
 <td align="center">
 <a href="https://github.com/pragya1204">
 <img src="https://avatars.githubusercontent.com/u/135381931?v=4" width="100;" alt="pragya1204"/>
 
 Pragya
 </a>
 </td>
 <td align="center">
 <a href="https://github.com/krisharmaa">
 <img src="https://avatars.githubusercontent.com/u/195412062?v=4" width="100;" alt="krisharmaa"/>
 
 Krish Sharma
 </a>
 </td>
		</tr>
	<tbody>
</table>

---

## 🧭 License

This project is released under the **MIT License** — feel free to use, modify, and distribute with proper credit.

---

⭐ **If you like this project, give it a star on [GitHub](https://github.com/skully-coder/shiksha-ai)!**

shiksha-ai

shiksha-ai Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

shiksha-ai

shiksha-ai Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README