What is FinAI?
FinAI is a smart personal finance management web application that revolutionizes expense tracking by leveraging Google Gemini 2.0 Flash AI to automatically categorize transactions and provide real-time financial insights through an interactive chatbot. Unlike traditional expense trackers that require tedious manual data entry and category selection, FinAI understands natural language descriptions like “Dinner with friends 500k” and automatically detects the category (Dining) and processes the amount - making financial management effortless.Current Stage: FinAI is in active MVP (Minimum Viable Product) development. Core AI features and transaction tracking are fully functional, while budgeting and advanced analytics are being enhanced.
Key Features
AI-Powered Categorization
Smart NLP engine that automatically categorizes transactions from natural language descriptions without manual selection
Context-Aware Chatbot
Interactive RAG (Retrieval Augmented Generation) assistant that answers questions based on your actual wallet balances and transaction history
Multi-Wallet System
Manage multiple fund sources including Cash, Bank Accounts, and Credit Cards with automatic balance tracking
Visual Reports
Interactive charts (Pie, Bar, Line) powered by Chart.js to visualize your cash flow trends and spending patterns
AI Capabilities
FinAI’s intelligence is powered by Google Gemini 2.0 Flash, providing:Natural Language Processing
Describe your expenses naturally and let AI handle the categorization:Intelligent Financial Advice
The built-in chatbot provides context-aware insights:- Real-time spending analysis based on your transaction history
- Warnings when unusual spending patterns are detected
- Personalized recommendations based on your financial behavior
Smart Category Mapping
The AI learns from your custom categories and maps transactions accordingly, ensuring accurate financial tracking tailored to your needs.Technology Stack
Backend
- Python 3.11+
- Flask Web Framework
- SQLAlchemy ORM
- SQLite Database
AI & Data
- Google Gemini 2.0 Flash
- Pandas for data processing
- RAG for context-aware responses
Frontend
- HTML5, CSS3, JavaScript
- Bootstrap 5
- Chart.js
Core Components
FinAI’s architecture is built on several key modules:| Component | Description | Status |
|---|---|---|
| Transaction Engine | Record income, expenses, and transfers with automatic balance updates | ✅ Fully Functional |
| AI Categorization | Smart NLP-based transaction categorization using Gemini 2.0 | ✅ Fully Functional |
| RAG Chatbot | Context-aware financial assistant with real-time data access | ✅ Fully Functional |
| Visual Reports | Export to Excel, generate print-friendly reports, interactive charts | ✅ Fully Functional |
| Multi-Wallet Management | Track multiple sources of funds simultaneously | ✅ Fully Functional |
| Budgeting Module | Set monthly budget limits with alerts | 🚧 In Development |
| Admin Analytics | System-wide analytics and user management | 🚧 In Development |
Use Cases
FinAI is perfect for:- Personal Finance Management: Track daily expenses, income, and transfers across multiple wallets
- Budget Planning: Monitor spending patterns and set financial goals
- Financial Literacy: Learn from AI-powered insights about your spending behavior
- Quick Expense Logging: Add transactions using natural language without navigating complex forms
- Data Analysis: Export transaction history to Excel for deeper offline analysis
What Makes FinAI Different?
Context-Aware Intelligence
The chatbot knows your actual balances and transaction history, not generic advice
Privacy-Focused
All data stored locally in SQLite - your financial information never leaves your server
Project Background
FinAI originated as a graduation thesis at Duy Tan University and is currently maintained and enhanced by Trần Nhật Quý (@Montero52) as an extended version for personal portfolio and AI research. The project is open-source and actively developed for educational and research purposes, showcasing real-world applications of Large Language Models in personal finance management.Next Steps
Ready to get started with FinAI?Installation
Set up FinAI on your local machine in under 5 minutes
Quick Start
Create your account and record your first transaction