Skip to content

πŸ› οΈ Prototype for the Hacknovate Hackathon 2025 (Agentic AI Track). UPISensei: An autonomous personal finance agent that understands, analyses, and explains UPI transactions automatically, transforming raw bank statement data into actionable financial insights using agentic AI. πŸ’΅

Notifications You must be signed in to change notification settings

saad2134/UPISensei

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

55 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’΅ UPISensei – AI-Driven UPI Spend Intelligence

🚨 An autonomous personal finance agent that understands, analyses, and explains UPI transactions automatically, transforming raw bank statement data into actionable financial insights using agentic AI.

πŸ”Ž Context

πŸ’‘ Prototype for Hacknovate 2025

  • Problem Statement Title: Agentic AI
  • Category: Software

πŸ’‘ Proposed Solution

UPISensei provides an intelligent, agentic workflow that extracts UPI data from multiple sources and converts it into structured insights. Users can upload monthly bank statements or scan UPI QR codes during payment time. The agent automatically identifies transaction details, assigns categories, and generates summaries and visual explanations.


✨ Key Features

  • Upload bank statements or scan UPI QR codes to extract embedded details automatically.
  • AI-driven categorization with user-editable tags.
  • Clean, visual summaries of spending patterns and history.
  • Offline-first architecture ensuring full privacy and zero external data sharing.

🎯 Problem Resolution

  • Removes the need for manual tracking or spreadsheets.
  • Converts raw UPI data into meaningful structured insights.
  • Reduces categorization errors through continuous learning from user input.
  • Helps users maintain financial clarity without complex budgeting apps.

πŸ”₯ Unique Value Propositions

  • QR-based logging allows instant capture of transaction info, even before statements arrive.
  • Agentic AI explains patterns and generates summaries automatically.
  • 100% offline data processing builds strong trust and adoption.
  • Adaptive tagging system evolves with each user’s habits.

πŸ“Š Feasibility and Viability

  • Parsing bank statements and UPI QR formats is technically mature and achievable.
  • High nationwide UPI usage ensures a broad and relevant user base.
  • Offline-first approach keeps costs low and simplifies DevOps.
  • No server infrastructure improves long-term sustainability.

βœ… Why It Works

  • Users prefer automation over manual entry.
  • Visual, gamified summaries reduce cognitive load.
  • Private, device-side processing increases confidence.
  • Accuracy improves the more the user interacts with the system.

⚠️ Current Challenges & Risks

  • Bank statements differ widely across institutions.
  • QR data may sometimes be incomplete depending on the source.
  • Initial categorization may require correction to improve model accuracy.
  • Expectations may grow beyond the intended core features.

πŸ›‘οΈ Strategies to Overcome

  • Build flexible parsers that support multiple bank formats.
  • Provide manual fallback when QR metadata is missing.
  • Apply incremental learning from user adjustments.
  • Communicate scope clearly to prevent unnecessary feature requests.

πŸ“š Research & References

  • NPCI documentation on UPI QR payload structure.
  • RBI reports on digital payment adoption in India.
  • Consumer behavior research on habit-forming finance tools.
  • Studies showing visual spending insights increase user retention.

Key Supporting Market Facts

  • India handles billions of UPI transactions monthly.
  • Most users do not maintain structured financial tracking.
  • Offline personal finance tools show higher long-term engagement rates.

Research Validation

  • Users prefer clear visual summaries over spreadsheets.
  • Automated QR/statement logging reduces friction significantly.
  • Privacy-first tools experience lower churn.

πŸ’‘ Takeaway

Strong user demand + high technical feasibility + private offline processing = UPISensei solves a real, validated need. Gamified, visual insights match exactly what users expect from a modern UPI-based financial assistant.


πŸ“ˆ Success Metrics

  • Auto-categorization accuracy rate.
  • Number of statement or QR imports per user.
  • Monthly active usage and retention.
  • Time saved versus manual logging.

🎯 Impact on Target Audience

  • Students gain daily spending clarity.
  • Professionals track monthly budgets easily.
  • Small businesses log UPI payments instantly.
  • Anyone using UPI gains a private, automated finance assistant.

βš™οΈ Platforms

Platform Supported?
Web (any browser with JS functionality) + Fully Responsive βœ…
Android (non-natively through WebView) βœ…

πŸ› οΈ Tech Stack

  • Frontend: React, Next.js, Typescript, TailwindCSS, shadcn/ui
  • Backend: Node.js/Python with AI microservices
  • Database: MongoDB/PostgreSQL
  • AI/ML: TensorFlow, PyTorch for predictive analytics
  • APIs Integration: ...
  • Hosting: Vercel/Firebase/AWS/GCP cloud infrastructure

πŸš€ Getting Started

Web Frontend

  1. Clone & Download the Repo

  2. Install NodeJS on your system.

  3. Open the project in your preferred IDE.

  4. Run in Terminal to Install all dependancies:

    npm i
  5. Get all api keys in env.template as set them in your env:

  6. Run in Terminal to Start Development Server:

    npm run dev

πŸ“ Project Architecture *

  • Soon.

πŸ“± Screenshots *

πŸ‘₯ Our Hacknovate Hackathon 2025 Team (#33 DevBandits)

# Team Member Role GitHub Profile
1 Fareed Ahmed Owais 🎯 Team Lead πŸ”— FareedAhmedOwais
2 Abdur Rahman Qasim πŸ”Ž Research Engineer πŸ”— Abdur-rahman-01
3 Mohammed Saad Uddin πŸš€ Full-stack + AI/ML Developer πŸ”— saad2134
4 MD Shoaib Ahmed πŸ”— Backend Support πŸ”— XSHOAIB
5 Mir Ayan Ali 🧩 Backend Engineer πŸ”— mirayanali5
6 Mohammed Abdul Mugees πŸ’Ό Solutions Engineer πŸ”— mug3es

πŸ“Š Repo Stats

Repo Size Last Commit Open Issues Open PRs License Forks Stars Watchers Contributors Languages Top Language

⭐ Star History

Star History Chart

✨ Icon

Image

πŸ”° Banner

Image

✍️ Endnote

Developed with πŸ’– for the Hacknovate 2025, with heartfelt thanks to Methodist College of Engineering & Technology for the opportunity to build and innovate.


🏷 Tags

#WebApp #Hacknovate-2025 #fintech #upi #digital-payments #qr-payments #expense-tracker #personal-finance #finance-app #banking #transaction-analysis #data-extraction #ocr #receipt-scanner #categorization #automation #shoaib

About

πŸ› οΈ Prototype for the Hacknovate Hackathon 2025 (Agentic AI Track). UPISensei: An autonomous personal finance agent that understands, analyses, and explains UPI transactions automatically, transforming raw bank statement data into actionable financial insights using agentic AI. πŸ’΅

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Contributors 9