Ai Finance coach is an app which lets you analyse your spending and income & help you make decisions.
FinSense is not just another expense tracker.
It is an AI-powered personal finance coach that understands your actual spending habits, answers questions about your money using your real transaction data, and gives you genuinely personalised financial advice — not generic tips.
Built entirely with modern Android development practices: zero XML layouts, full Jetpack Compose UI, Clean Architecture, and a RAG pipeline powered by Gemini AI.
| Onboarding | Login | Dashboard | Transactions |
|---|---|---|---|
 |
 |
 |
 |
| Add Transaction | Transaction Detail | Budget Tracking |
|---|---|---|
 |
 |
 |
| Add Budget | AI Chat (Empty) | AI Chat (Active) |
|---|---|---|
 |
 |
 |
| AI Insights | Monthly Report | Profile |
|---|---|---|
 |
 |
 |
Minimum Android version: Android 8.0 (API 26)
- Track income and expenses across Cash, UPI, Bank, Credit Card
- 14 smart spending categories with custom emoji
- Recurring transaction automation
- Full transaction history with search and filters
- Month-by-month navigation
- Set monthly spending limits per category
- Real-time budget health score (0–100)
- Visual progress tracking with status indicators
- AI-suggested budget limits based on spending history
- Alerts before you overspend — not after
- Ask anything about your finances in plain English
- AI answers grounded in YOUR actual transaction data
- Streaming responses token by token
- Proactive AI insights about spending patterns
- AI-generated monthly financial reports
- Chat history persists across sessions
- Google Sign-In via Firebase Auth
- All transaction data stored locally on device first
- Optional cloud sync via Firebase Firestore
- No third-party data sharing
┌──────────────────────────────────────────────────┐
│ RAG Pipeline │
│ │
│ User Question │
│ ↓ │
│ BuildFinancialContextUseCase │
│ → Last 30 transactions from Room DB │
│ → Active budgets + spending totals │
│ → Income, savings rate, top categories │
│ ↓ │
│ Structured Financial Context │
│ (real numbers, real categories, real dates) │
│ ↓ │
│ Gemini 1.5 Flash API │
│ [System Prompt] + [Financial Context] │
│ + [Chat History] + [User Question] │
│ ↓ │
│ Streamed Response (token by token) │
│ ↓ │
│ Personalised Answer based on YOUR data │
└──────────────────────────────────────────────────┘
Result:
- ❌ Generic: "Try to spend less on food"
- ✅ RAG: "You spent ₹8,400 on Zomato last month — that's 34% above your food budget of ₹6,200"
┌────────────────────────────────────────────────┐
│ Presentation Layer │
│ Jetpack Compose Screens + ViewModels │
│ StateFlow + collectAsStateWithLifecycle() │
└──────────────────┬─────────────────────────────┘
│
┌──────────────────▼─────────────────────────────┐
│ Domain Layer │
│ Use Cases + Repository Interfaces │
│ Pure Kotlin — zero Android dependencies │
└──────────┬───────────────────┬─────────────────┘
│ │
┌──────────▼──────┐ ┌────────▼─────────────────┐
│ Local Data │ │ Remote Data │
│ │ │ │
│ Room DB │ │ Gemini 1.5 Flash API │
│ (Transactions, │ │ Firebase Auth │
│ Budgets, │ │ Firebase Firestore │
│ AI Messages) │ │ Firebase Storage │
└─────────────────┘ └──────────────────────────┘
Pattern: MVVM + Clean Architecture
DI: Hilt
Async: Kotlin Coroutines + Flow
Navigation: Jetpack Navigation Compose
| Layer | Technology |
|---|---|
| Language | Kotlin |
| UI | Jetpack Compose (zero XML) |
| Architecture | MVVM + Clean Architecture |
| DI | Hilt |
| Local DB | Room |
| Vector Store | ObjectBox |
| AI | Gemini 1.5 Flash via Google AI SDK |
| Auth | Firebase Auth (Google Sign-In) |
| Cloud DB | Firebase Firestore |
| Storage | Firebase Storage |
| Charts | Vico (Compose native) |
| Image Loading | Coil |
| Background Jobs | WorkManager |
| Preferences | DataStore |
| Fonts | Sora + DM Sans (Google Fonts) |
app/src/main/java/com/yourname/finsense/
│
├── data/
│ ├── local/ # Room DB, DAOs, Entities
│ ├── remote/ # Gemini API, Firebase sources
│ ├── repository/ # Repository implementations
│ ├── mapper/ # Entity ↔ Domain mappers
│ ├── datastore/ # DataStore preferences
│ └── worker/ # WorkManager workers
│
├── domain/
│ ├── model/ # Pure Kotlin domain models
│ ├── repository/ # Repository interfaces
│ └── usecase/ # All business logic
│
├── presentation/
│ ├── auth/ # Onboarding, Login, Profile Setup
│ ├── dashboard/ # Home screen
│ ├── transaction/ # List, Add, Detail, Recurring
│ ├── budget/ # Tracking + Setup
│ ├── ai/ # Chat, Insights, Report
│ ├── settings/ # Profile + Preferences
│ ├── components/ # Reusable Compose components
│ ├── navigation/ # NavGraph + Screen routes
│ └── theme/ # Color, Type, Shape, Theme
│
└── di/ # Hilt modules
- Android Studio Hedgehog or later
- JDK 17
- Kotlin 1.9+
- A Google account for Firebase
git clone https://github.com/yourusername/finsense.git
cd finsense- Go to Firebase Console
- Create a new project named "FinSense"
- Add an Android app with package name
com.yourname.finsense - Download
google-services.json - Place it in the
app/directory - Enable these Firebase services:
- Authentication → Google Sign-In
- Firestore Database
- Storage
- Go to Google AI Studio
- Create a free API key
- Open
local.propertiesin root directory - Add:
GEMINI_API_KEY=your_api_key_here
./gradlew assembleDebugOr simply press Run in Android Studio.
- Download the APK from Releases
- On your Android device:
- Go to Settings → Security
- Enable "Install from Unknown Sources"
- Open the downloaded APK
- Follow installation prompts
- RAG on mobile is more powerful than expected and completely feasible with Gemini's free tier
- Clean Architecture paid off significantly as the app grew — each layer stayed completely independent
- Streaming AI responses dramatically improves perceived performance and user experience
- Jetpack Compose with proper state management (StateFlow + collectAsStateWithLifecycle) is genuinely production-ready
- Hilt makes dependency injection nearly invisible once set up correctly
Pull requests are welcome. For major changes please open an issue first to discuss what you would like to change.