KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

ai-savings-advisor

★ 1 Open GitHub ↗

A rule-based financial decision-making engine built with Python and Streamlit to provide personalized savings recommendations and budget analysis.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 💰 AI Personal Saving Advisor

🔥 Build a smart Financial Decision-Making System using Python, Pandas & Streamlit!

📌 **Part of:** Super Sunday Project Series 🚀
👉 New project every Sunday
👉 Learn by building real-world projects

---

## ⭐ Support & Follow

If this project helps you:

⭐ **Star this repository** 👤 **Follow me on GitHub** for more projects  
📺 **Watch full video:** [Insert YouTube Link Here]

---

## 🎥 Project Preview

A professional **AI-Powered Financial Advisor Dashboard** built using Python. 
Unlike a simple tracker, this application uses a **Rule-Engine** to analyze your financial health, calculate a "Savings Score," and project your wealth over the next 10 years based on the 50/30/20 rule.

---

## ✨ Features

🧠 **Rule-Based AI Engine**
* Intelligent scoring system (0-100) based on financial logic.
* Automated feedback on your Emergency Fund status and "Wants" spending.

📊 **50/30/20 Rule Analysis**
* Instant comparison of your current spending vs. global financial standards.
* Dynamic status updates (Healthy, Moderate, or Critical).

📈 **Interactive Spending Breakdown**
* Beautiful Donut Charts powered by **Plotly**.
* Real-time metrics for Needs, Wants, and Savings.

💰 **10-Year Wealth Projector**
* Interactive slider to project future savings at a 10% annual return.
* Visualize the power of long-term compounding.

📑 **Generate Report**
* Export your personalized financial advice as a text file.

---
## ScreenShots
<img width="1356" height="628" alt="AI Python Project" src="https://github.com/user-attachments/assets/def64c86-e10e-410a-88de-c1c6a44e00f5" />
<img width="1343" height="611" alt="AI Project" src="https://github.com/user-attachments/assets/f7ad389c-7392-4a84-ab49-b9715f6ce8dc" />

---

## 🚀 Getting Started

### 🔧 Prerequisites
Make sure you have installed:
* Python 3.8 or above
* pip (Python package manager)

---

## ⚙️ Installation & Setup (Single Step Copy-Paste)

Follow these steps to get the project running on your local machine:

### 1️⃣ Setup Environment
Copy and paste these commands into your terminal:

```bash
# Clone the repository
git clone [https://github.com/YOUR_USERNAME/ai-savings-advisor.git](https://github.com/YOUR_USERNAME/ai-savings-advisor.git)
cd ai-savings-advisor

# Create Virtual Environment
python -m venv venv

# Activate Virtual Environment
# For Windows:
venv\Scripts\activate
# For Mac/Linux:
# source venv/bin/activate

# Install Dependencies
pip install streamlit pandas plotly
```

### 2️⃣ Run the Application
Once the dependencies are installed, start the dashboard:

```bash
streamlit run app.py
```

👉 App will open automatically in your browser at: `http://localhost:8501`

---

## 🛠️ Tech Stack

* **Frontend/UI:** Streamlit
* **Rule Engine Logic:** Python (Expert System)
* **Visualizations:** Plotly Express
* **Data Handling:** Pandas

---

## 💡 Key Learning Outcomes

* **Decision Logic:** Building a rule-engine to evaluate user data.
* **Financial Math:** Implementing compound interest and budget percentage logic.
* **Data Visualization:** Creating interactive charts for better UX.
* **Clean UI:** Using Streamlit metrics, sidebars, and columns.
* **Professional Branding:** Integrating "Study Trigger" styles into code.

---

## 📁 Project Structure

```
ai-savings-advisor/
│
├── app.py             # Main Application Code
├── README.md          # Documentation
└── assets/            # Images & Screenshots
```

---

## 🚀 Future Enhancements

* 🔐 **User Authentication:** Save multiple user profiles.
* 📈 **Live Market Data:** Integration with real-time stock/mutual fund APIs.
* 📄 **PDF Export:** Generate professional PDF financial plans.
* 🤖 **LLM Integration:** Add a "Chat with Advisor" feature using Gemini or OpenAI.

---

## 👨‍💻 Developed By

**Mahesh Verma** Founder - **Study Trigger** 🚀

---

## ⭐ Show Your Support

If you like this project:
⭐ **Star the repo** | 📢 **Share with friends** | 💬 **Give feedback**

---

🔥 *Learn by Building. Build to Learn.*
```

ai-savings-advisor

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README