WealthForge AI

Multi-agent AI financial coach by Sharad Khare.

WealthForge AI is a Google ADK-powered financial advisor that analyzes your income, expenses, and debts through three specialized Gemini agents — delivering budget insights, savings strategies, and debt payoff plans with interactive charts.

Built and maintained by Sharad Khare — AI strategist, full-stack developer, and creator of practical agent workflows.

---

What this project does

WealthForge turns your financial inputs into a complete coaching package:

1. Budget Analysis — categorizes spending, finds savings opportunities, compares income vs expenses

2. Savings Strategy — emergency fund sizing, monthly allocation recommendations, automation tips

3. Debt Reduction — avalanche vs snowball payoff comparisons with interest and timeline projections

Agents run sequentially, each building on the previous agent's state for coherent, personalized advice.

---

Why Sharad Khare built WealthForge AI

Personal finance coaching requires multiple lenses — spending habits, savings goals, and debt strategy. WealthForge demonstrates how Google ADK's sequential multi-agent pattern produces comprehensive financial guidance from a single Streamlit workflow.

---

How it works

Financial Inputs (income, expenses, debts)
   │
   ▼
Budget Analysis Agent (gemini-2.5-flash)
   └── state['budget_analysis']
   │
   ▼
Savings Strategy Agent
   └── state['savings_strategy']
   │
   ▼
Debt Reduction Agent
   └── state['debt_reduction']
   │
   ▼
Interactive Plotly dashboards in Streamlit

Input options

| Method | Details |

|--------|---------|

| CSV upload | Date, Category, Amount columns with validation |

| Manual entry | Nine expense categories with live summary |

| Debt entry | Up to 10 debts with rate and minimum payment |

---

Features

• Three-agent sequential pipeline via Google ADK
• CSV transaction upload with validation and preview
• Manual expense entry by category
• Debt payoff comparison (avalanche vs snowball)
• Plotly pie charts, bar charts, and comparison views
• Emergency fund progress tracking
• Downloadable CSV expense template

---

Quick start

cd wealthforge-ai
pip install -r requirements.txt
streamlit run app.py

Required API key

• Google API key — set GOOGLE_API_KEY in .env or enter in the sidebar

---

Example use cases

• Monthly budget review with category breakdown
• Emergency fund planning for households with dependants
• Comparing debt payoff strategies before committing extra payments
• Identifying top spending categories to cut costs

---

Project structure

wealthforge-ai/
├── app.py
├── wealthforge/
│   ├── config.py
│   ├── schemas.py
│   ├── csv_utils.py
│   ├── system.py
│   └── display.py
├── requirements.txt
├── pyproject.toml
└── README.md

---

Who this is for

• Individuals managing household budgets and debt
• Financial coaches prototyping AI-assisted workflows
• Developers learning Google ADK multi-agent patterns
• Anyone wanting structured savings and debt guidance

Use cases

• Upload bank CSV exports for automated spending analysis
• Enter expenses manually for quick monthly reviews
• Compare avalanche vs snowball debt payoff timelines
• Get emergency fund and automation recommendations

---

Author

• Website: sharadkhare.in

License

MIT © Sharad Khare