https://github.com/zerodiscord/sentinal-ai
https://github.com/zerodiscord/sentinal-ai
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/zerodiscord/sentinal-ai
- Owner: ZeroDiscord
- Created: 2025-07-02T10:58:07.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-03T11:40:41.000Z (12 months ago)
- Last Synced: 2025-07-03T12:38:15.727Z (12 months ago)
- Language: JavaScript
- Size: 143 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SentinelAI
[](https://sentinal-ai-nine.vercel.app/)
**Live Demo:** [https://sentinal-ai-nine.vercel.app/](https://sentinal-ai-nine.vercel.app/)
SentinelAI Incident Reporting
💡 Why
For Google Developer Groups (GDG) On-Campus organiser hiring, I had to devise a technical solution to solve an issue the community or college was struggling with. With the use of Google technologies and the proper inspiration, I was able to do that.
💻 Overview
SentinelAI is an advanced AI-driven incident management software for schools and campuses. Using state-of-the-art AI (Google Gemini) to process, classify, and escalate incident reports, it provides real-time dashboards, role-based security, and simple user management.
📌 Motivation
Besides being a coder and a tech enthusiast, I am also an extremely engaged member of the University's official Student Discipline Committee, DC. In my committee work, one glaring lack that I have noticed is the lack of one, intelligent platform for reporting and managing incidents in the campus.
Current students are tasked with physically forwarding an email to the Chief Proctor Office (CPO) for reporting emergency and disciplinary issues. The system is suboptimal and flawed:
- Emails are unstructured and hard to prioritize.
- They tend to lack well-organized, actionable information.
- There is no protocol or authentication.
- No assurance of follow-up or visibility to the concerned authority.
Through the SentinelAI platform, we are able to:
- Permit students to report incidents in text reviewing them with Gemini AI.
- Auto-extract such vital information like category (i.e., harassment, ragging, theft), severity, time, and location.
- Real-time reporting of incidents to the concerned authority by role and access (e.g., School Proctors, Wardens, Secretaries, or Chief Proctor Office).
- Offer a real-time dashboard to proctorial and security officials, displaying active incidents, and charts.
- Offer anonymous reporting with privacy and escalation capabilities.
- Replace unstructured email-based reporting with structured, AI-tagged reports that are traceable, searchable, and prioritizable.
With the incorporation of modern front-end design vibecoded by Google's IDX powered by Google's cloud and AI stack, combined with real-world domain know-how in university discipline processes, SentinelAI demonstrates a scalable, high-impact solution that is not a prototype and is close to production-grade maturity.
âš¡ Core Features
-
Role-Based Authentication: Safe login and role management (e.g., CPO, school proctor, warden, student).
-
Incident Report: Incident report information (description, where, optional media uploads).
-
AI Incident Analysis: Summarizes and annotates incidents, classifies them, and estimates their severity using Gemini API and also provides escalation recommendations.
-
Incident Dashboard: Real-time incident dashboard to view, filter, and manage incidents by role, school, and others.
-
Real-time Notifications: Notifications for critical events.
-
User Management: Management of user profiles to view and update their information.
💻 Tech Stack
-
Frontend: Next.js (React), Tailwind CSS, Radix UI, Lucide Icons
-
Backend: Next.js API routes, Firebase (Firestore, Auth), Gemini API (Google GenAI)
-
AI Integration: Centralized in src/ai/gemini.js and flows
-
Authentication: Firebase Auth (Google, email/password, anonymous)
-
Styling: Glassmorphism, Inter/Google Sans fonts, and a custom color palette:
-
Primary Blue: #60a5fa (used for highlights, buttons, and icons)
-
Accent Indigo: #6366f1 (used for gradients and accent elements)
-
Background Slate: #0f172a and #1e293b (main backgrounds and cards)
-
Glass Card Overlay: semi-transparent white (rgba(255,255,255,0.08)) for glassmorphism effect
-
Text Foreground: #f1f5f9 (main text), #94a3b8 (muted text)
-
Success/Resolved: #22c55e
-
Warning: #facc15
-
Destructive/Error: #ef4444
🚀 Getting Started
Prerequisites
- Node.js 20+
- Firebase project (Firestore, Auth enabled)
- Gemini API key (Google GenAI)
Installation
-
Clone the repository:
git clone https://github.com/ZeroDiscord/Sentinal-AI
cd sentinelai
-
Install dependencies:
npm install
-
Set up environment variables:
(See .env.example for required keys)
-
Configure Firebase:
- Create a Firebase project at console.firebase.google.com.
- Enable Firestore and Authentication (Google, email/password, and anonymous sign-in).
- In the Firebase console, add a web app and copy the config into your
.env.local file.
-
Run the development server:
npm run dev
The app will be available at http://localhost:3000.
-
(Optional) Deploy:
- You can deploy to your preferred platform.
- Make sure to set the same environment variables in your deployment settings.