README.md

Puzzle Realms

A web-based portal for various kinds of puzzle games that help improve logical thinking, spatial reasoning and boost cognitive abilities. Built using Django, Python, HTML, and JavaScript.

Objectives

The portal is designed in order to check various algorithm efficiency and how well it can be optimized when solving puzzle logics at the same time used for entertainment for people of all ages.

Website

Portal can be accessed from Puzzle Realms

Demo

Short video of the games can be watched from Demo

Documentation

• Project Plan
• Reflective Essay
• Technical Documentation

Code Docstrings

• N-Queens
• Polysphere Pro
• Polsyphere Extreme

All the tickets opened for bugs and issues can be found Here.

Games

N-Queens Solver

Polysphere Pro

Polysphere Extreme

Follow us for more exciting future projects below:

• Rohan Kadam
• Tom Naccarato
• Jawad Nasar Shah
• Junkai Ou
• Mya Lwin
• Rimjhm Chakraborty
• Veerpal Kaur

Local Installation Guide

Install Visual Studio Code (VSCode):

Step 1

Go to the official VSCode Website Download the installer for your operating system (Windows, macOS, or Linux). Run the installer and follow the installation prompts. Install PyCharm (Optional):

OR

If you also want to install PyCharm Community Version, go to the official PyCharm Website Download the installer for your operating system. Run the installer and follow the installation prompts.

Step 2

Download our project and Extract the Zip Source Folder : Locate the source folder you want to extract. Right-click on the folder and choose "Extract" or use a zip utility program to extract the contents. Open the Project Folder in VSCode:

Step 3

Install Python Packages from requirements.txt: Open a terminal or command prompt. Navigate to the project directory where requirements.txt is located. Run the following command to install the required packages:

pip install -r requirements.txt

Step 4

Launch VSCode. Click on "File" in the menu and select "Open Folder". Navigate to the location where you extracted the source folder, select it, and click "Open".

Step 5

Open a terminal within VSCode (click on "Terminal" in the menu, then "New Terminal"). Navigate to the project directory (where manage.py is located). Run the following command to start the Django server:

cd portal ; python manage.py runserver

OR

cd portal ; python manage.py runserver 0.0.0.0: xxxx ( Replace xxxx with any port you want to use to run the server on aside from default 8000)

Now open a web browser and browse the following address:

http://localhost:8000 or http://127.0.0.1:8000

The server should now be running, That's it!!. Enjoy playing !!