README.md

---
title: Amortization Report
emoji: 📊
colorFrom: pink
colorTo: purple
sdk: gradio
app_file: app.py
pinned: false
license: mit
sdk_version: 5.29.1
---

# 📊 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