Update README.md

README.md

@@ -8,3 +8,55 @@ app_file: app.py
 pinned: false
 license: mit
 ---
+
+# 📊 Amortization Report
+
+This interactive app helps you generate a full amortization schedule for any loan. Simply enter your loan amount, interest rate, and loan period, and you'll get:
+
+- A detailed amortization table
+- A breakdown of interest and principal paid per year
+- A line chart showing remaining balance over time
+
+Built with Python, Gradio, NumPy Financial, Pandas, and Matplotlib — and hosted on Hugging Face Spaces.
+
+---
+
+## 🔢 How It Works
+
+**Input Parameters:**
+
+- **Loan Amount (Principal)** – Total amount borrowed  
+- **Annual Interest Rate (%)** – Input as a percentage (e.g., type `5` for 5%)  
+- **Number of Periods (Years)** – Duration of the loan in years
+
+**Output:**
+
+- 📋 **Amortization Table** showing payment, interest, principal, and balance per year  
+- 📈 **Payment Breakdown Plot** comparing interest and principal over time  
+- 📉 **Remaining Balance Chart** showing how your debt is paid off
+
+---
+
+## 🧪 Example
+
+Try entering the following:
+
+- Loan Amount (Principal): 100000
+- Annual Interest Rate (%): 5.00
+- Number of Periods (Years): 10
+
+
+You’ll see how the loan amortizes — how much you pay in interest and principal each year, and how the balance decreases over time.
+
+---
+
+## 📦 Installation
+
+Clone the repo and install the required packages:
+
+```bash
+git clone https://huggingface.co/spaces/ali-denewade/amortization-report
+cd amortization-report
+pip install -r requirements.txt
+
+