MindSafe - Unified Platform

Video.Project.mp4

"Protecting minds. Preventing harm."

A comprehensive AI-powered platform for child online protection and wellbeing, integrating three major components into a unified experience.

Quick Start

Windows

# Run the startup script
.\start_mindsafe.ps1

Manual Setup

# Install Python dependencies
pip install flask

# Install Node.js dependencies for React components
cd dashboard && npm install && cd ..
cd "child abuse and support/abuse_support_portal/frontend" && npm install && cd ../../..

# Install mental health assistant dependencies
cd mental_health_assistant && pip install -r requirements.txt && cd ..

# Start the unified server
python server.py

Access Points

• Main Homepage: http://localhost:8080
• AI Safety Dashboard: http://localhost:3000
• Child Abuse Support Portal: http://localhost:3001
• Mental Health Assistant: http://localhost:5000

Platform Components

1. AI Safety Filter (Browser Extension + Dashboard)

• Location: dashboard/ and extension/
• Technology: React.js, Chrome Extension APIs
• Features:
  • Real-time content filtering and blocking
  • ML-powered detection of harmful content
  • Parental dashboard with analytics
  • Browser extension for live protection

2. Child Abuse Support Portal

• Location: child abuse and support/abuse_support_portal/
• Technology: React.js, Flask, MongoDB
• Features:
  • Anonymous abuse reporting system
  • AI-powered severity classification
  • NGO/helpline integration
  • Support request management

3. Mental Health Assistant

• Location: mental_health_assistant/
• Technology: Flask, AI/ML models
• Features:
  • CBT-based conversational AI
  • Mood check-ins and wellness exercises
  • Crisis intervention alerts
  • Emotional support chatbot

Technology Stack

Frontend

• React.js - Component-based UI
• Tailwind CSS - Utility-first styling
• Chrome Extension APIs - Browser integration

Backend

• Flask - Python web framework
• MongoDB - NoSQL database
• REST APIs - Component communication

AI/ML

• Hugging Face Transformers - NLP models
• OpenCV - Image processing
• Sentiment Analysis - Emotion detection
• Content Moderation - Safety filtering

Integrations

• Twilio - SMS notifications
• SendGrid - Email services
• Perspective API - Text moderation

Project Structure

MindSafe/
├── index.html                 # Main homepage
├── server.py                  # Unified server
├── start_mindsafe.ps1         # Windows startup script
├── README.md                  # This file
├── dashboard/                 # AI Safety Dashboard
│   ├── src/App.js            # Main dashboard component
│   └── package.json          # Node.js dependencies
├── child abuse and support/   # Abuse Support Portal
│   └── abuse_support_portal/
│       ├── frontend/         # React frontend
│       └── backend/          # Flask backend
├── mental_health_assistant/  # Mental Health Assistant
│   ├── app.py               # Flask application
│   ├── templates/           # HTML templates
│   └── static/              # CSS/JS assets
└── extension/               # Browser Extension
    ├── manifest.json        # Extension manifest
    ├── popup.html          # Extension popup
    └── content_script.js   # Content filtering

Key Features

Safe Browsing Filter

• Real-time ML-based blocking of toxic chats, explicit images, and violent videos
• Browser extension for live protection
• Parental dashboard with detailed analytics

Anonymous Abuse Reporting

• Secure, child-friendly reporting portal
• AI-powered severity detection
• Automatic escalation to NGOs/helplines
• Evidence upload and management

Mental Health Support

• Conversational AI chatbot with CBT-based exercises
• Mood tracking and wellness activities
• Crisis detection and intervention
• Professional resource integration

Parental Dashboard

• Centralized monitoring of all safety incidents
• Real-time analytics and safety scorecards
• Alert management and response tracking
• Child wellbeing insights

API Endpoints

Unified Server

• GET / - Main homepage
• GET /api/status - Component status
• GET /api/start/<component> - Start component
• GET /api/stop/<component> - Stop component

Component Redirects

• GET /dashboard - AI Safety Dashboard
• GET /abuse-support - Child Abuse Support Portal
• GET /mental-health - Mental Health Assistant

Crisis Resources

• National Suicide Prevention Lifeline: 1-800-273-8255
• Crisis Text Line: Text HOME to 741741
• Emergency Services: 911
• Childline India: 1098

Expected Impact

• Protect children from harmful online exposure
• Empower children to report abuse safely and anonymously
• Support mental health via accessible AI assistant
• Provide parents with actionable insights for early intervention

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

Support

For support or questions:

• Create an issue in the repository
• Contact the development team
• Check the documentation in each component directory

---

MindSafe - Building a safer digital world for children, one component at a time.