🎓 Grade Evaluator Web Application

A simple Web Application built with Flask that allows users to input a numerical grade and receive a corresponding letter grade or an "Invalid input" message if the grade is outside the 1-100 range. The app features a clean, responsive user interface styled with CSS.

---

🌐 Live Demo

Click Here 🚀

---

✨ Features

• Grade Calculation: Converts numerical grades (1-100) into letter grades (A+ to F).
• Input Validation: Checks for grades outside the valid range (1-100) and non-numerical inputs.
• User-Friendly Interface: Simple form for grade submission.
• Responsive Design: Styled with CSS for a visually appealing experience.

---

🚀 Technologies Used

• Backend: Python (Flask)
• Frontend: HTML, CSS

---

📁 Project Structure

The project follows a standard Flask application layout:

Grade/
├── grade.py           Main Flask application logic
├── README.md          Project documentation
├── templates/
│   └── index.html     HTML template for the web page
└── static/
    └── style.css      CSS stylesheet for styling

---

⚙️ Setup and Installation

Follow these steps to get the Grade Evaluator running on your local machine.

Prerequisites

• Python 3.x installed. Download from python.org.
• pip package installer (usually included with Python).

Installation Steps

1. Clone the repository (if applicable) or create the project structure with the files as shown above.

2. Navigate to the project directory:

   cd C:\Users\HP\OneDrive\Desktop\PHYTON\Grade

   (Adjust the path to your project location.)

3. (Optional but recommended) Create and activate a virtual environment:

   • Create virtual environment:

     python -m venv venv

   • Activate virtual environment:

     • On Windows:

       .\venv\Scripts\activate

     • On macOS/Linux:

       source venv/bin/activate

---

📋 Requirements

Alternatively, you can create a requirements.txt file in your project root with the following content:

Flask

Then install dependencies using:

pip install -r requirements.txt

---

▶️ How to Run the Application

1. Ensure your virtual environment is activated (if you created one).

2. Run the Flask application from the root directory (Grade folder):

   python grade.py

3. Open your browser and go to: http://127.0.0.1:5000/

4. To stop the server, press Ctrl + C in your terminal.

---

📝 Usage

1. Open the application in your web browser.
2. Enter a numerical grade between 1 and 100 in the input field.
3. Click the "Check Grade" button.
4. The corresponding letter grade or an error message will be displayed below the form.

---

🤝 Contributing

Feel free to fork this repository, make improvements and submit pull requests. Your contributions are welcome!

---

📬 Contact

If you have any questions, issues, or suggestions, feel free to reach out. I'd love to hear from you!

• Open an Issue 💬
• LinkedIn 👤
• Email ✉️
• Telegram 📱

---

📅 Date of Completion

This project was completed on: August 1, 2025 🗓️

By: Gemachis Tesfaye [https://github.com/urjiiko1] ✨