Skip to content

A desktop app for League of Legends players to get better and spicy build recommendations for ranked games. Built with Python, React, TypeScript, and Electron.

License

jspenaq/LolSapiens

Repository files navigation

LolSapiens

LolSapiens is a desktop application that helps players of the popular video game League of Legends to get better recommendations and build suggestions for their ranked games. The app leverages the power of Python 3.10 for the backend, React 18 and TypeScript for the frontend, and Electron for the desktop environment. With this combination, the app provides a seamless and optimized user experience.

The app analyzes data from lolalytics.com to generate unique and spicy ways to play the game, helping players to improve their game and increase their chances of winning.

Requirements

To run this project, you need to have the following tools installed:

  • Python 3.10
  • Node.js v16
  • React 18
  • TypeScript
  • Electron

Getting Started

Clone the repository to your local machine using the following command:

git clone https://github.com/jspenaq/LolSapiens.git

Navigate to the project directory:

cd LolSapiens

Install the required dependencies for the backend:

pip install -r requirements.txt

Start the backend server:

python main.py -s

This will start the backend server on http://localhost:3200.

Install the required dependencies for the frontend:

# Move to frontend dir
cd frontend

npm install

Start the frontend server:

npm run dev

This will start the frontend server on http://localhost:5173.

Use Electron to build and run the desktop application:

# Move to desktop dir
cd desktop

npm run electron

To compile Electron app:

npm run make

image

image

Contributing

If you want to contribute to the project, please fork the repository and make the necessary changes. Once you're ready, you can submit a pull request for review.

License

This project is licensed under the GNU GENERAL PUBLIC LICENSE Version 3.

Disclaimer

LolSapiens is an independent software application and is not endorsed, sponsored, or affiliated with Riot Games, Inc. or League of Legends. The app utilizes data from lolalytics.com, but does not guarantee the accuracy or completeness of such data. The recommendations and build suggestions generated by the app are for informational purposes only and should not be taken as professional advice. The use of LolSapiens is at the user's own risk and the creators and developers of the app will not be held responsible for any losses or damages resulting from the use of the app.

Acknowledgments

  • jspenaq - The mastermind behind the project and the king of Python.
  • Anvido - The wizard of frontend development who brought the app to life with React, TypeScript and Electron.
  • dfcastanedat - The frontend ninja who made sure the app is smooth and responsive.
  • LAHIGUARANS - The designer who made the logo look stunning and the tester who made sure everything works as expected.
  • jsbecerrab - The copy-paster who contributed to the project by finding and using some useful code snippets from StackOverflow.
  • ChatGPT - The AI language model that helped in generating this README.md file.

About

A desktop app for League of Legends players to get better and spicy build recommendations for ranked games. Built with Python, React, TypeScript, and Electron.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published