CIS_6005_Project

🧠 Personality Predictor - AI Model

A machine learning application that predicts personality types (Introvert/Extrovert) based on behavioral patterns with 96.9% accuracy.

🌐 Live Application

🚀 Try the Live App

Note: The web application is now live at the root URL above. Click the link to access the interactive personality predictor!

✨ Features

• 🤖 AI-Powered: 96.9% accurate personality prediction
• 📊 Beautiful UI: Modern, responsive design
• 📱 Mobile Friendly: Works on all devices
• ⚡ Real-time: Instant predictions with confidence scores
• 📈 Insights: Detailed personality trait explanations
• 🔒 Privacy: No data storage, all processing is local

🎯 How It Works

The application analyzes 7 key behavioral patterns:

1. Time Spent Alone (hours per day)
2. Social Event Attendance (per month)
3. Going Outside (times per week)
4. Friends Circle Size
5. Post Frequency (per week)
6. Stage Fear (Yes/No)
7. Drained After Socializing (Yes/No)

Based on these inputs, the AI model predicts whether you’re an Introvert or Extrovert with a confidence score.

🚀 Quick Start

Option 1: Use the Live App

Simply visit https://samuux23.github.io/CI_project/ and start predicting!

Option 2: Run Locally

1. Clone the repository

   git clone https://github.com/Samuux23/CI_project.git
   cd CI_project
   

2. Static HTML App (Recommended)
   • Open webapp/index.html in your web browser
   • No server setup required!
3. Flask App (Single File)

   cd webapp
   pip install -r requirements_single_app.txt
   python personality_predictor_app.py
   # Open: http://localhost:5000
   

4. Windows Quick Start
   • Double-click webapp/start_app.bat

📊 Model Performance

• Algorithm: Gradient Boosting Classifier
• Accuracy: 96.9%
• Training Data: 18,526 samples
• Features: 7 behavioral patterns
• Classes: Introvert (0), Extrovert (1)

🏗️ Project Structure

CIS_6005/
├── backend/                      # 🔧 Backend API Services
│   ├── main.py                  # FastAPI backend server
│   ├── requirements.txt         # Backend dependencies
│   └── requirements_simple.txt  # Simplified dependencies
├── frontend/                    # 🎨 React Frontend Application
│   ├── package.json            # Node.js dependencies
│   ├── public/                 # Static assets
│   └── src/                    # React source code
├── webapp/                      # 🌐 Web Applications Folder
│   ├── index.html              # Static web app (GitHub Pages)
│   ├── personality_predictor_app.py # Flask version (single file)
│   └── README.md               # Web app documentation
├── Final_Code.py               # 🧠 Complete ML Pipeline
├── requirements.txt            # Python dependencies
├── best_comprehensive_model.pkl # Trained model
├── preprocessor_comprehensive.pkl # Data preprocessor
├── train.csv                   # Training dataset
├── test.csv                    # Test dataset
├── README.md                   # This file
└── .github/workflows/          # GitHub Actions
    └── streamlit-deploy.yml    # Deployment workflow

🎨 Technologies Used

• Frontend: HTML, CSS, JavaScript (GitHub Pages)
• Alternative: Streamlit, Python, scikit-learn
• ML Model: Gradient Boosting Classifier
• Deployment: GitHub Pages, Streamlit Cloud
• Styling: Custom CSS with gradients

📈 Model Training

The model was trained using:

• Hyperparameter Optimization: Comprehensive grid search
• Feature Engineering: Advanced preprocessing pipeline
• Cross-validation: 5-fold CV for robust evaluation
• Ensemble Methods: Multiple algorithms tested

🔧 Development

🌐 Web Applications (in webapp/ folder)

📖 Detailed Documentation: See webapp/README.md for comprehensive guide

Static Version (Recommended for GitHub Pages)

The webapp/index.html file contains a complete static version that:

• ✅ Works without any server setup
• ✅ Runs entirely in the browser
• ✅ Uses JavaScript-based prediction logic
• ✅ Maintains the same beautiful UI
• ✅ Provides instant results

Flask Version (Single File)

The webapp/personality_predictor_app.py provides:

• ✅ Complete Flask backend + HTML frontend
• ✅ Uses actual trained ML model
• ✅ Easy local deployment
• ✅ Single file solution

🚀 Deployment

GitHub Pages (Current)

• URL: https://samuux23.github.io/CI_project/
• Type: Static HTML/CSS/JavaScript
• Status: ✅ Live and working

Streamlit Cloud (Alternative)

• URL: https://personality-predictor.streamlit.app
• Type: Full ML model deployment
• Status: Available for advanced users

📝 Usage Examples

Extrovert Pattern

• Time alone: 1-2 hours
• Social events: 8+ per month
• Going outside: 6+ times per week
• Friends: 12+ people
• Posts: 5+ per week
• Stage fear: No
• Drained: No

Introvert Pattern

• Time alone: 6+ hours
• Social events: 2-3 per month
• Going outside: 2-3 times per week
• Friends: 2-5 people
• Posts: 1-2 per week
• Stage fear: Yes
• Drained: Yes

🤝 Contributing

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

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

• Built with modern web technologies
• Powered by machine learning algorithms
• Deployed on GitHub Pages for easy access

---

🎯 Ready to discover your personality type? Click here to start!