Upload 3 files

app.py

@@ -0,0 +1,148 @@
+import streamlit as st
+import pandas as pd
+import matplotlib.pyplot as plt
+
+# Title of the app
+st.title("🎓 CGPA Calculator: Unlock Your Academic Potential 🚀📈")
+
+# Custom CSS for background and sidebar
+st.markdown("""
+    <style>
+        /* Main page background */
+        [data-testid="stAppViewContainer"] {
+            background-image: url("https://img.freepik.com/free-photo/abstract-blur-pastel-beautiful-peach-pink-color-sky-warm-tone-background-design-as-bannerslide-show-others_1258-100366.jpg?semt=ais_hybrid&w=740");
+            background-size: cover;
+            background-position: center;
+            background-repeat: no-repeat;
+        }
+
+        /* Sidebar background */
+        [data-testid="stSidebar"] {
+            background-image: url("https://i.pinimg.com/236x/ff/39/6f/ff396fca7f47cc3d2ca55ebc53e93bc7.jpg");
+            background-size: cover;
+            background-repeat: no-repeat;
+            background-position: center;
+            color: white;
+        }
+
+        /* Button style */
+        .stButton>button {
+            background-color: #4CAF50;
+            color: white;
+            font-size: 16px;
+            font-weight: bold;
+            border-radius: 8px;
+            padding: 12px;
+            margin-top: 10px;
+            width: 100%;
+        }
+        .stButton>button:hover {
+            background-color: #45a049;
+        }
+
+        /* Text input border style */
+        .stTextInput>div>div>input {
+            border: 2px solid #8B0000 !important;
+            border-radius: 5px;
+        }
+
+        /* Footer style */
+        .footer {
+            font-size: 14px;
+            color: #666666;
+            text-align: center;
+            padding: 20px 0;
+        }
+    </style>
+""", unsafe_allow_html=True)
+
+# Sidebar content
+st.sidebar.markdown("## 👨‍💻 Connect with Me")
+st.sidebar.markdown("""
+<div>
+    <a href="https://github.com/marianadeem755" target="_blank">
+        <img src="https://cdn-icons-png.flaticon.com/512/25/25231.png" width="30px"> GitHub
+    </a><br><br>
+    <a href="https://www.kaggle.com/marianadeem755" target="_blank">
+        <img src="https://cdn4.iconfinder.com/data/icons/logos-and-brands/512/189_Kaggle_logo_logos-512.png" width="30px"> Kaggle
+    </a><br><br>
+    <a href="mailto:marianadeem755@gmail.com">
+        <img src="https://cdn-icons-png.flaticon.com/512/561/561127.png" width="30px"> Email
+    </a><br><br>
+    <a href="https://huggingface.co/maria355" target="_blank">
+        <img src="https://huggingface.co/front/assets/huggingface_logo-noborder.svg" width="30px"> Hugging Face
+    </a>
+</div>
+""", unsafe_allow_html=True)
+
+# Input Section
+st.header("Enter Your Semester GPAs")
+num_semesters = st.number_input("How many semesters have you completed?", min_value=1, max_value=20, step=1, value=1)
+
+# GPA input fields
+gpa_list = []
+for i in range(1, num_semesters + 1):
+    gpa = st.number_input(f"Enter GPA for Semester {i}:", min_value=0.0, max_value=4.0, step=0.01, value=0.0)
+    gpa_list.append(gpa)
+
+# Calculate CGPA
+if st.button("Calculate CGPA"):
+    if gpa_list:
+        cgpa = sum(gpa_list) / len(gpa_list)
+        st.success(f"Your CGPA is: {cgpa:.2f}")
+
+        highest_gpa = max(gpa_list)
+        lowest_gpa = min(gpa_list)
+        average_gpa = sum(gpa_list) / len(gpa_list)
+
+        st.header("Advanced Features")
+
+        st.subheader("GPA Summary")
+        st.write(f"Highest GPA: {highest_gpa:.2f}")
+        st.write(f"Lowest GPA: {lowest_gpa:.2f}")
+        st.write(f"Average GPA: {average_gpa:.2f}")
+
+        st.subheader("GPA Trend")
+        fig, ax = plt.subplots()
+        ax.plot(range(1, len(gpa_list) + 1), gpa_list, marker='o', linestyle='-', color='b')
+        ax.set_title("GPA Trend Over Semesters")
+        ax.set_xlabel("Semester")
+        ax.set_ylabel("GPA")
+        ax.set_ylim(0, 4.0)
+        st.pyplot(fig)
+
+        # Create DataFrame for download
+        data = {
+            "Semester": [f"Semester {i+1}" for i in range(len(gpa_list))],
+            "GPA": gpa_list
+        }
+        df = pd.DataFrame(data)
+        summary_df = pd.DataFrame({
+            "Metric": ["CGPA", "Highest GPA", "Lowest GPA", "Average GPA"],
+            "Value": [cgpa, highest_gpa, lowest_gpa, average_gpa]
+        })
+
+        combined_df = pd.concat([df, pd.DataFrame([["", ""]], columns=["Semester", "GPA"]),
+                                 summary_df.rename(columns={"Metric": "Semester", "Value": "GPA"})],
+                                ignore_index=True)
+
+        csv = combined_df.to_csv(index=False).encode('utf-8')
+        st.download_button(
+            label="📥 Download Results as CSV",
+            data=csv,
+            file_name="cgpa_results.csv",
+            mime='text/csv'
+        )
+    else:
+        st.error("Please enter at least one GPA.")
+
+# Reset Button
+if st.button("Reset"):
+    st.experimental_rerun()
+
+# Footer
+st.markdown("""
+    <div class="footer">
+        <p>© 2025 CGPA Calculator | Made by Maria Nadeem</p>
+    </div>
+""", unsafe_allow_html=True)

readme.md

@@ -0,0 +1,71 @@
+# 🎓 CGPA Calculator
+
+This is a **Streamlit** web application that helps users calculate their CGPA (Cumulative Grade Point Average) based on their semesters GPA. This app provides advanced features like GPA trend visualization, GPA summary and the ability to download results as a CSV file.
+
+---
+
+## 🚀 Features
+
+- **Input Semester GPAs**: Enter GPAs for multiple semesters.
+- **CGPA Calculation**: Automatically calculates the CGPA based on the entered GPAs.
+- **GPA Summary**:
+  - Highest GPA
+  - Lowest GPA
+  - Average GPA
+- **GPA Trend Visualization**: Displays a line chart showing GPA trends over semesters.
+- **Download Results**: Export GPA data and summary as a CSV file.
+- **Reset Functionality**: Reset the app to start fresh.
+
+---
+
+## 🛠️ Installation
+1. Navigate to the project directory:
+   ```bash
+   cd cgpa-calculator
+   ```
+2. Install the required dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+---
+
+## ▶️ Usage
+
+1. Run the Streamlit app:
+   ```bash
+   streamlit run app.py
+   ```
+
+2. Enter the number of semesters and their respective GPAs.
+3. Click **Calculate CGPA** to view the results.
+4. Optionally, download the results as a CSV file or reset the app.
+
+---
+
+## 📊 GPA Trend Visualization
+
+The app generates a line chart to visualize GPA trends over semesters. This helps users track their academic performance over time.
+
+---
+
+## 📥 Download Results
+
+Users can download their GPA data and summary as a CSV file for future reference.
+
+---
+
+## 📚 Technologies Used
+
+- **Python**
+- **Streamlit**: For building the web app.
+- **Pandas**: For data manipulation.
+- **Matplotlib**: For GPA trend visualization.
+
+---
+
+
+## 🌟 Acknowledgments
+
+- Built with [Streamlit](https://streamlit.io/).
+---

requirements.txt

@@ -0,0 +1,4 @@
+streamlit
+pandas
+matplotlib
+fpdf