Skip to content

atmihaa-06/KinetIQ

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš— KINETIQ

Intelligence in Motion

AI-powered Personalized Driver Behaviour Intelligence System


πŸ“– Overview

KINETIQ is an intelligent Driver Behaviour Monitoring platform that combines Artificial Intelligence, Computer Vision, and Real-Time Analytics to enhance road safety through continuous driver behaviour analysis.

Unlike traditional Driver Monitoring Systems (DMS) that rely on predefined thresholds, KINETIQ builds a personalized Driver Behaviour Fingerprint for every driver by learning their unique driving characteristics over time. The system continuously monitors behavioural metrics, detects anomalies, generates intelligent alerts, and provides actionable insights through an interactive analytics dashboard.

Built with a modern full-stack architecture, KINETIQ integrates a React frontend, FastAPI backend, PostgreSQL database, and AI-powered behaviour analysis to deliver a scalable, secure, and intuitive monitoring solution.


✨ Key Features

πŸ” Authentication & Security

  • Secure User Registration
  • JWT Authentication
  • Protected Routes
  • Password Encryption using BCrypt
  • Session Persistence
  • Role-Based API Protection

πŸ‘€ Driver Profile Management

  • Personalized Driver Profiles
  • Profile Updates
  • Driver Information Dashboard
  • Behaviour Profile Association
  • Secure Account Management

🚘 Driver Monitoring

  • Live Driver Monitoring
  • Session Management
  • Behaviour Tracking
  • Continuous Driver Observation
  • Real-Time Monitoring Interface

🧠 AI Behaviour Intelligence

Real-time analysis of:

  • Driver Attention
  • Blink Rate
  • Fatigue Level
  • Risk Score
  • Mobile Phone Detection
  • Behaviour Fingerprinting

🚨 Intelligent Alert System

Automatic detection of:

  • Driver Fatigue
  • Driver Distraction
  • Unsafe Driving Behaviour
  • Mobile Phone Usage
  • High Risk Events

πŸ“Š Analytics Dashboard

Interactive visualization of:

  • Driver Behaviour Trends
  • Attention Analytics
  • Fatigue Analytics
  • Risk Analysis
  • Behaviour Fingerprints
  • Session Statistics

πŸ“‘ Reports & Insights

  • Driving History
  • Session Reports
  • Behaviour Summary
  • Driver Performance Reports
  • Historical Analytics

⚑ Real-Time Communication

  • REST API Integration
  • WebSocket Communication
  • Live Dashboard Updates
  • Instant Behaviour Streaming

πŸ— System Architecture

                   React + Vite Frontend
                           β”‚
                           β–Ό
                    Authentication Layer
                           β”‚
                           β–Ό
                    FastAPI REST APIs
                           β”‚
      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
      β”‚                    β”‚                    β”‚
      β–Ό                    β–Ό                    β–Ό
 Driver Profiles     Monitoring Engine    Analytics Engine
      β”‚                    β”‚                    β”‚
      β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β–Ό
               Behaviour Fingerprint Engine
                           β”‚
                           β–Ό
                 PostgreSQL Database (Neon)
                           β”‚
                           β–Ό
                WebSocket Live Communication

πŸ”„ System Workflow

User Registration
        β”‚
        β–Ό
Secure Authentication
        β”‚
        β–Ό
Driver Profile Creation
        β”‚
        β–Ό
Start Monitoring Session
        β”‚
        β–Ό
Driver Behaviour Analysis
        β”‚
        β–Ό
Behaviour Metrics Collection
        β”‚
        β–Ό
Risk & Alert Detection
        β”‚
        β–Ό
Behaviour Fingerprint Generation
        β”‚
        β–Ό
Analytics Dashboard
        β”‚
        β–Ό
Historical Reports

🧠 Behaviour Intelligence Workflow

Live Driver Camera
        β”‚
        β–Ό
Computer Vision
(OpenCV + MediaPipe)
        β”‚
        β–Ό
Feature Extraction
        β”‚
        β–Ό
Driver Metrics Engine
        β”‚
        β–Ό
Behaviour Fingerprint
        β”‚
        β–Ό
Anomaly Detection
        β”‚
        β–Ό
Risk Assessment
        β”‚
        β–Ό
Alert Generation
        β”‚
        β–Ό
Dashboard Visualization

πŸ›  Tech Stack

Frontend

  • React.js
  • Vite
  • Tailwind CSS
  • Framer Motion
  • React Router DOM
  • Axios
  • Lucide React

Backend

  • FastAPI
  • SQLAlchemy
  • PostgreSQL (Neon)
  • Uvicorn
  • Pydantic

Authentication

  • JWT
  • Passlib
  • BCrypt

Database

  • PostgreSQL (Neon)
  • SQLAlchemy ORM

AI & Computer Vision

  • OpenCV
  • MediaPipe Face Mesh
  • YOLOv8
  • Scikit-Learn
  • Isolation Forest

Real-Time Communication

  • WebSockets

Deployment

  • Render
  • Neon PostgreSQL

πŸ“‚ Project Structure

KINETIQ
β”‚
β”œβ”€β”€ frontend
β”‚   β”œβ”€β”€ public
β”‚   β”œβ”€β”€ src
β”‚   β”‚   β”œβ”€β”€ assets
β”‚   β”‚   β”œβ”€β”€ components
β”‚   β”‚   β”œβ”€β”€ layouts
β”‚   β”‚   β”œβ”€β”€ pages
β”‚   β”‚   β”œβ”€β”€ routes
β”‚   β”‚   β”œβ”€β”€ services
β”‚   β”‚   β”œβ”€β”€ hooks
β”‚   β”‚   └── utils
β”‚   β”‚
β”‚   β”œβ”€β”€ package.json
β”‚   └── README.md
β”‚
β”œβ”€β”€ backend
β”‚   β”œβ”€β”€ app
β”‚   β”œβ”€β”€ requirements.txt
β”‚   β”œβ”€β”€ .env
β”‚   └── README.md
β”‚
β”œβ”€β”€ LICENSE
└── README.md

πŸ“‘ Core Modules

πŸ” Authentication

  • User Registration
  • User Login
  • JWT Authentication
  • Protected APIs

πŸ‘€ Driver Profiles

  • Driver Information
  • Profile Management
  • Secure Updates

🚘 Monitoring

  • Live Monitoring
  • Session Tracking
  • Behaviour Recording
  • Driver Observation

🧠 Behaviour Intelligence

  • Driver Fingerprinting
  • Attention Analysis
  • Fatigue Analysis
  • Risk Prediction

πŸ“Š Analytics

  • Behaviour Trends
  • Driver Statistics
  • Performance Metrics
  • AI Insights

πŸ“‘ Reports

  • Historical Sessions
  • Behaviour Reports
  • Performance Summary
  • Monitoring History

πŸš€ Running Locally

Clone Repository

git clone https://github.com/<your-username>/KINETIQ.git

cd KINETIQ

Frontend Setup

cd frontend

npm install

npm run dev

Runs at

http://localhost:5173

Backend Setup

cd backend

python -m venv .venv

Windows

.venv\Scripts\activate

Linux / macOS

source .venv/bin/activate

Install dependencies

pip install -r requirements.txt

Create a .env

DATABASE_URL=
SECRET_KEY=
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=60

Run the server

uvicorn app.main:app --reload

Backend runs at

http://127.0.0.1:8000

πŸ“– API Documentation

Swagger UI

http://127.0.0.1:8000/docs

ReDoc

http://127.0.0.1:8000/redoc

🎯 Future Enhancements

  • Driver Emotion Recognition
  • Voice-Based Driver Assistance
  • Predictive Fatigue Forecasting
  • Fleet Monitoring Dashboard
  • Cloud-Based Analytics
  • ADAS Integration
  • Behaviour-Based Driver Authentication
  • Mobile Companion Application
  • Edge AI Deployment
  • Insurance Risk Assessment
  • Smart Driver Scoring
  • Multi-Camera Monitoring

πŸ‘₯ Team

Project: KINETIQ – Intelligence in Motion

Developed for Hackathon 2026

Development Team

Name Role
Atmihaa MB Backend Developer
Niranjan J Menon Frontend Developer

"Understanding the driver behind the wheel, not just the vehicle on the road."


πŸ“œ License

This project has been developed exclusively for educational, research, and hackathon purposes.


🌟 Vision

"Transforming Driver Safety Through Intelligent Behaviour Analysis."

About

About AI-powered Driver Behaviour Monitoring & Intelligence System using React, FastAPI and Computer Vision.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors