FIFA-Player-Recomendation

Installation Guide

This guide will help you set up the FIFA Player Recommendation System on your local machine.

Prerequisites

Before you begin, ensure you have the following installed:

Step-by-Step Installation

1. Clone the Repository

git clone https://github.com/inboxpraveen/FIFA-Player-Recomendation.git
cd FIFA-Player-Recomendation

Windows:

python -m venv venv
venv\Scripts\activate

macOS/Linux:

python3 -m venv venv
source venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

This will install:

4. Verify Dataset

Ensure the datasets are in place:

new-data/
├── male_players.csv    (~16,000 players)
└── female_players.csv  (~1,500 players)

5. Train the Models

# Train both models (default)
python training/train.py

# Train only male players model
python training/train.py --male

# Train only female players model
python training/train.py --female

# Skip specific model
python training/train.py --skip-male     # Train female only
python training/train.py --skip-female   # Train male only

📖 For detailed training options and troubleshooting, see training/README.md

This will:

Training Time:

Expected Output:

models/
├── male_model.pkl    (~1 GB)
└── female_model.pkl  (~10 MB)

6. Run the Application

python run.py

Or directly run the Flask app:

cd app
python main.py

7. Access the Application

Open your web browser and navigate to:

http://localhost:5000

You should see the FIFA Player Recommendation System home page!

Troubleshooting

Issue: “Models not found”

Solution: Train the models first (Step 5)

Issue: “Module not found” error

Solution: Ensure virtual environment is activated and dependencies are installed

pip install -r requirements.txt

Issue: Port 5000 already in use

Solution: Use a different port

# Edit app/main.py, change:
app.run(debug=True, host='0.0.0.0', port=5001)  # Use 5001 instead

Issue: Training script not found

Solution: Ensure you’re in the project root directory

cd FIFA-Player-Recomendation
python training/train.py

Issue: Large model files not loading

Solution: Ensure you have at least 2 GB free RAM

Issue: CSV parsing errors

Solution: Ensure CSV files are UTF-8 encoded

Verification Checklist

After installation, verify everything works:

Production Deployment

For production deployment, see Deployment Guide in PROJECT_SUMMARY.md.

Quick Production Setup

# Install gunicorn
pip install gunicorn

# Run with gunicorn
gunicorn -w 4 -b 0.0.0.0:5000 app.main:app

System Requirements

Minimum

Performance Tips

  1. Use SSD - Faster model loading
  2. Increase RAM - Better concurrent user support
  3. Use production server - gunicorn instead of Flask dev server
  4. Enable caching - Redis for frequently accessed data
  5. Use CDN - For static assets in production

Next Steps

Once installed:

  1. Read the README.md for usage instructions
  2. Check PROJECT_SUMMARY.md for technical details
  3. See CONTRIBUTING.md to contribute
  4. Report issues on GitHub Issues

Getting Help

If you encounter issues:

  1. Check this guide’s troubleshooting section
  2. Search existing GitHub issues
  3. Open a new issue with:
    • Your OS and Python version
    • Error messages
    • Steps to reproduce

Uninstallation

To remove the application:

# Deactivate virtual environment
deactivate

# Remove project directory
cd ..
rm -rf FIFA-Player-Recomendation  # macOS/Linux
# or
rmdir /s /q FIFA-Player-Recomendation  # Windows

Happy Recommending! ⚽

This site is open source. Improve this page.