GitHub Project Setup & README

I have a school assignment that lives entirely on GitHub. All of the code is already written; what I still need is the repository itself and a crystal-clear Markdown README that guides any reader through the project.

Here is what I expect from you:

• Create or organise the GitHub repository, commit the existing source files, and structure branches in a sensible way.
• Write a well-formatted README.md that covers, at a minimum:
– what the project does and its standout features,
– how the folder structure is organised and why,
– exact installation and run commands so a classmate or instructor can reproduce the result on the first try.
• Make sure the README renders cleanly on GitHub, using headings, code blocks, and any badges or images you feel add clarity.

You are free to suggest small improvements to the repo layout, but the focus is documentation, not coding. Everything must be pushed directly to GitHub so I can submit the link as my final deliverable.