Skip to content

An AI-powered salary prediction app built with Python and Streamlit. Features a modern, responsive UI and a machine learning model with 96% R² accuracy.

License

Notifications You must be signed in to change notification settings

SpicychieF05/salary_scope

Repository files navigation

Salary Scope Banner

Salary Scope

AI-powered, mobile-optimized salary prediction app with a modern, glowing UI.


✨ Features

  • Modern, Responsive UI: Beautiful dark theme, glowing blue accents, and perfect alignment on all devices (desktop, tablet, mobile).
  • Custom Header: Logo, app name, and social icons (GitHub, LinkedIn, Twitter, Discord) with real links.
  • Glowing Accuracy Badge: Eye-catching, pill-shaped badge with a checkmark and blue gradient.
  • Interactive Form: User-friendly, grouped fields for salary prediction.
  • AI-Powered: Uses a Gradient Boosting Regressor model with R² = 0.96 (96%) accuracy.
  • Easy Deployment: Optimized for Streamlit Community Cloud.

🖼️ Screenshots

Default App View

Default view of the app showing the prediction form with input fields and custom styling

Prediction Output

Results view showing the predicted salary based on user inputs with confidence score


🛠️ Tech Stack & Tools

  • Frontend & Backend: Python, Streamlit
  • Machine Learning: scikit-learn, pandas, numpy
  • Model: Gradient Boosting Regressor
  • Deployment: Streamlit Community Cloud

🚀 Getting Started (Local Development)

# 1. Clone the repository
   git clone <https://github.com/SpicychieF05/salary_scope>
   cd Salary-scope

# 2. Create a virtual environment
   python -m venv venv
   venv\Scripts\activate  # On Windows
   # or
   source venv/bin/activate  # On macOS/Linux

# 3. Install dependencies
   pip install -r requirements.txt

# 4. Train the model (if needed)
   python train_model.py

# 5. Run the app locally
   streamlit run app_streamlit.py

The app will be available at http://localhost:8501


☁️ Deploying on Streamlit Community Cloud

  1. Push your code to GitHub.
  2. Go to Streamlit Cloud and sign in.
  3. Click "New app" and connect your GitHub repo.
  4. Set the main file to app_streamlit.py.
  5. Deploy!
    • Streamlit Cloud will build and start your app.
    • Visit your Streamlit Cloud URL to use Salary Scope.
    • Live App: SalaryScope.streamlit.app

📊 Model Performance

  • Model: Gradient Boosting Regressor
  • Accuracy Score (R²): 96%

📁 Project Structure

Salary-scope/
  app_streamlit.py
  train_model.py
  requirements.txt
  model.joblib
  label_encoder.joblib
  static/
  assets/
  README.md

🌐 Social & Credits


📄 License

Distributed under the MIT License. See LICENSE for details.

About

An AI-powered salary prediction app built with Python and Streamlit. Features a modern, responsive UI and a machine learning model with 96% R² accuracy.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages