https://github.com/nichsedge/sansfinance
Sans Finance β A premium, on-device AI-powered personal finance and wealth management app. Track net worth, assets, liabilities, and monthly cash flow with privacy-first insights.
https://github.com/nichsedge/sansfinance
android android-development budget-tracker clean-architecture expense-tracker hilt jetpack-compose kotlin litert material3 money-management mvvm net-worth-tracker on-device-ai personal-finance privacy-first room-database sqlite wealth-management
Last synced: 26 days ago
JSON representation
Sans Finance β A premium, on-device AI-powered personal finance and wealth management app. Track net worth, assets, liabilities, and monthly cash flow with privacy-first insights.
- Host: GitHub
- URL: https://github.com/nichsedge/sansfinance
- Owner: nichsedge
- Created: 2026-04-04T05:01:13.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-13T18:08:40.000Z (about 1 month ago)
- Last Synced: 2026-05-13T20:12:29.415Z (about 1 month ago)
- Topics: android, android-development, budget-tracker, clean-architecture, expense-tracker, hilt, jetpack-compose, kotlin, litert, material3, money-management, mvvm, net-worth-tracker, on-device-ai, personal-finance, privacy-first, room-database, sqlite, wealth-management
- Language: Kotlin
- Size: 2.11 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Sans Finance π¦
Sans Finance is a premium, AI-powered personal finance and wealth management application. It provides a comprehensive dashboard to track your entire financial lifeβfrom daily expenses to long-term net worth, including investments and portfolio tracking.

## β¨ Features
- **Comprehensive Dashboard:** Monitor your Net Worth, Total Assets, and Liabilities in a single, beautiful view.
- **Wealth & Portfolio Tracking:** Track your investments across different accounts and visualize your wealth distribution.
- **Monthly Cash Flow:** Track income, expenses, and your monthly savings rate with interactive charts.
- **AI-Powered Insights**:
- **Cloud AI**: Advanced monthly reviews and transaction analysis via **OpenAI** or **OpenRouter**.
- **Local AI (Planned)**: Privacy-focused on-device suggestions (Coming Soon).
- **Budgets & Goals:** Set financial goals and track your progress with dedicated budget management.
- **Installment & Debt tracking:** Manage long-term payment plans and use the **Debt Strategist** to optimize repayments.
- **Advanced Statistics:** Analyze spending and account trends over multiple timeframes.
- **Privacy First:** Core data processing is local, ensuring your financial privacy.
## π Tech Stack
- **Architecture:** Kotlin Multiplatform (KMP) + Clean Architecture
- **Mobile UI:** [Jetpack Compose](https://developer.android.com/compose)
- **Backend:** [Ktor](https://ktor.io/)
- **Dependency Injection:** [Hilt](https://dagger.dev/hilt/) (Android)
- **Local Database:** [Room](https://developer.android.com/training/data-storage/room) (SQLite) - Version 31
- **AI:** OpenAI & OpenAI-compatible APIs (OpenRouter); Local AI (Planned)
- **Data Persistence:** DataStore (Preferences)
## π Project Structure
- `:app` β Android Application
- `:shared` β Common Domain & Data Logic (KMP)
- `:server` β Companion Ktor Server
## π Getting Started
### Prerequisites
- Android device/emulator with **API level 36+**.
- [Android Studio Ladybug](https://developer.android.com/studio) or newer.
- JDK 17.
### Build and Install
1. Clone the repository:
```bash
git clone https://github.com/nichsedge/sans-finance.git
```
2. Open the project in Android Studio.
3. Build and run the `app` module.
Alternatively, use the provided build script:
```bash
./build_release.sh
```
The release APK will be available in the `release/` folder.
## π License
This project is licensed under the MIT License.
---
Built with β€οΈ by [nichsedge](https://github.com/nichsedge)