Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

21Afnan/FinSage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

7 Commits

Repository files navigation

๐Ÿ’ธ FinSage AI โ€“ Smart Personal Finance & Wealth Assistant

A voice-enabled finance management app that tracks income, expenses, goals, and generates smart insights โ€” powered by AI.


๐Ÿ“Œ Project Summary

FinSage AI is a personal finance desktop app that integrates:

  1. Smart Ledger with Voice Input

    • ๐ŸŽ™๏ธ Add transactions using voice commands
    • ๐Ÿ“‹ Tracks income, expenses, categories, and dates with real-time UI updates
  2. Automated Reports + Filters

    • ๐Ÿงพ Generate PDF reports with filters (date, city, province, party)
    • ๐Ÿ“Š View summaries of balances and transactions by category or location
  3. AI-Driven Insights (Upcoming)

    • ๐Ÿ“ˆ Forecast savings, expenses, and budgets using LSTM models
    • ๐Ÿค– Integrated chatbot for financial planning tips

๐Ÿง  How it Works

๐ŸŽ™๏ธ Voice Ledger Entry

  • Voice commands (via SpeechRecognition) converted into text
  • Parses entries like: "Add expense 1200 groceries"
  • Stores data in structured format in SQLite or Supabase

๐Ÿงพ Report Generation

  • Select filters (city, date range, party name, province)
  • Auto-generates styled PDF using FPDF / ReportLab
  • Reports include transaction breakdowns and balance charts

๐Ÿ“Š Financial Overview & Goals

  • Track goals like "Save 10k/month" or "Limit food to 5k"
  • Visual dashboards for category-wise spending
  • Daily, weekly, monthly summaries using matplotlib

๐Ÿงฐ Tech Stack

Category Tools / Frameworks
Language Python 3.10+
UI Framework Flutter
Voice Input SpeechRecognition
Data Storage SQLite / Supabase
Report Generation FPDF, ReportLab
Visualization Matplotlib
ML Forecasting (*) LSTM (Keras / TensorFlow)
NLP Chatbot (*) Gemini AI / OpenAI API

* in future versions (v4โ€“v5)


โš™๏ธ How to Run the Project

๐Ÿ”ง 1. Clone the Repository

git clone https://github.com/your-username/FinSageAI.git
cd FinSageAI

๐Ÿ”ง 2. Install Dependencies

pip install -r requirements.txt

๐Ÿ”ง 3. Set Credentials

  • Set Supabase config in database.py
  • Add Gemini/OpenAI keys for future ML/NLP features

๐Ÿš€ 4. Launch App

python main.py

โœจ Features

  • โœ… Voice-powered income/expense tracking
  • โœ… Custom filters for PDF report generation
  • โœ… User goal setting and budget visualization
  • โœ… Secure login and data persistence
  • ๐Ÿ”œ AI-based forecasting and finance chatbot

๐Ÿ”ฎ Future Plans

  • ๐Ÿ“ˆ Integrate LSTM-based savings/expense prediction
  • ๐Ÿ—ฃ๏ธ Launch AI chatbot for smart money guidance
  • โ˜๏ธ Sync data with cloud for mobile version
  • ๐Ÿ“ฑ Release Android/iOS version
  • ๐Ÿง  Add anomaly detection (fraud/overspending alerts)

๐Ÿ“ฉ Contact

๐Ÿ‘ค Afnan Shoukat ๐Ÿ“ง Email: afnanshoukat35@gmail.com

Feel free to reach out for:

  • ๐Ÿค Collaborations or use cases
  • ๐Ÿ’ฌ Suggestions or improvements
  • ๐Ÿงช Customization or integration support


About

FinSage is an AI-powered personal finance app that enables voice-controlled wealth management, expense tracking, and smart financial insights. It integrates voice-to-ledger automation, AI budgeting, and interactive reports for simplified money management.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

Languages

AltStyle ใซใ‚ˆใฃใฆๅค‰ๆ›ใ•ใ‚ŒใŸใƒšใƒผใ‚ธ (->ใ‚ชใƒชใ‚ธใƒŠใƒซ) /