[![PennyWise AI Banner](banner.png)](https://github.com/sarim2000/pennywiseai-tracker) [![GitHub stars](https://img.shields.io/github/stars/sarim2000/pennywiseai-tracker?style=social)](https://github.com/sarim2000/pennywiseai-tracker) [![License](https://img.shields.io/badge/license-AGPL%20v3-blue)](LICENSE) [![Android](https://img.shields.io/badge/Android-8.0%2B-3DDC84)](https://developer.android.com/about/versions/oreo/android-8.0) [![Kotlin](https://img.shields.io/badge/Kotlin-2.4.21-7F52FF)](https://kotlinlang.org/) [![Privacy](https://img.shields.io/badge/AI-100%25_On--Device-FF6B6B)](https://ai.google.dev/edge) [![Downloads](https://img.shields.io/badge/Downloads-100+-green)](https://play.google.com/store/apps/details?id=com.pennywiseai.tracker) [![F-Droid](https://img.shields.io/f-droid/v/com.pennywiseai.tracker?color=1976d2)](https://f-droid.org/packages/com.pennywiseai.tracker/) [![GitHub release](https://img.shields.io/github/v/release/sarim2000/pennywiseai-tracker)](https://github.com/sarim2000/pennywiseai-tracker/releases) [![GitHub last commit](https://img.shields.io/github/last-commit/sarim2000/pennywiseai-tracker)](https://github.com/sarim2000/pennywiseai-tracker/commits) [![Discord](https://img.shields.io/badge/Discord-Join_Community-5865F2)](https://discord.gg/H3xWeMWjKQ) [![Greptile: The War on Bugs](https://www.greptile.com/badge.svg)](https://www.greptile.com/?utm_source=oss_badge&utm_medium=readme&utm_campaign=greptile_for_open_source) ## PennyWise AI — Free & Open‑Source, private SMS‑powered expense tracker Turn bank SMS into a clean, searchable money timeline with on-device AI assistance. Parsing, storage, and AI all run on your phone. ⭐ **Star us on GitHub — join 300+ supporters!** [![Share](https://img.shields.io/badge/share-000000?logo=x&logoColor=white)](https://x.com/intent/tweet?text=Check%20out%20PennyWise%20AI%20-%20Privacy-first%20expense%20tracker%20with%20on-device%20AI:%20https://github.com/sarim2000/pennywiseai-tracker%20%23Android%20%23PrivacyFirst%20%23OnDeviceAI) [![Share](https://img.shields.io/badge/share-0A66C2?logo=linkedin&logoColor=white)](https://www.linkedin.com/sharing/share-offsite/?url=https://github.com/sarim2000/pennywiseai-tracker) [![Share](https://img.shields.io/badge/share-FF4500?logo=reddit&logoColor=white)](https://www.reddit.com/submit?title=PennyWise%20AI%20-%20Privacy-first%20expense%20tracker&url=https://github.com/sarim2000/pennywiseai-tracker) [![Share](https://img.shields.io/badge/share-0088CC?logo=telegram&logoColor=white)](https://t.me/share/url?url=https://github.com/sarim2000/pennywiseai-tracker&text=Check%20out%20PennyWise%20AI) ## Overview Your bank already texts you every transaction — PennyWise turns those SMS into a private, zero-setup expense tracker with on-device AI. No accounts, no sign-ups, no effort. Get it on Google Play Download on the App Store Get it on F-Droid ### How it works 1. **Grant SMS permission** (read-only) — no account creation, no inbox changes, no messages sent. 2. **PennyWise parses your transactions instantly** — extracts amount, merchant, category, and date. New SMS are detected in real-time. 3. **Get insights** — analytics, budgets, subscriptions, and an on-device AI assistant you can ask anything. 📖 **New here?** The [user guide](https://pennywise.zynth.dev/guide) walks through every feature step by step, with screenshots. ## Why PennyWise **Key Differentiators** - **🔒 Private by Design** — AI and transaction storage run on your phone; no accounts, no analytics, and your data leaves the phone only through opt-in features you start ([see Privacy](#privacy-first)) - **⚡ Zero Setup** — Just grant SMS permission, no accounts to create, works instantly - **🆓 Free & Open Source** — AGPL v3 licensed, no ads, no trackers; an optional **[PennyWise Pro](#pennywise-pro)** upgrade supports the solo developer - **🌐 Your Language** — Translated via Crowdin, with full Arabic (RTL) support; pick your language and currency on first launch **Core Features** - **🤖 Smart SMS Parsing** — 178 banks across 26 countries with real-time detection of incoming SMS; SMS from banks we don't support yet, and notifications from apps you pick, become suggested transactions - **🌍 Multi-Currency** — Per-account currency, live exchange rates, and totals that never mix currencies - **💬 On-Device AI Assistant** — Ask "What did I spend on food?", compare with last month, add or review transactions in plain words, or dictate with the mic — powered by Qwen 2.5, runs entirely on your phone - **🏷️ Categories, Tags & Smart Rules** — Sub-categories, emoji icons, renamable built-ins, learned merchant categories, and rules with multiple conditions and actions - **💰 Budgets & Savings Goals** — Category or type budgets with custom cycles (including last working day), per-day allowance, safe-to-spend and a month-end forecast; goals you add to straight from transactions - **📊 Analytics & Charts** — Group by category, merchant, account, tag or weekday; trends, heatmaps, top merchants, custom date ranges - **🏦 Accounts, Cards & Loans** — Live balances from SMS, balance history, discrepancy fixes, low-balance alerts, account merge, loans by person, and bill splits with UPI QR requests - **🔄 Subscriptions** — Spots repeat charges, suggests untracked bills, flags price changes, and reminds you before a bill is due - **📥 Statement Import** — PDF (including password-protected), Excel and CSV statements with column mapping, preview and balance check **More Features** - **🔐 Privacy Controls** — Biometric app lock, and hide amounts on every screen (or shake the phone to toggle) - **🔔 Smart Notifications** — Clear transaction alerts with a one-tap "Not an expense", bill reminders, and an opt-in spending conscience - **📱 Widgets & Quick Add** — Budget, recent transactions, spending pie and goal widgets; a Quick Settings tile and shortcut to add a transaction - **📤 Backup & Export** — Full backup/restore (.pennywisebackup) including settings and receipt photos, scheduled folder backups, CSV export, rule import/export - **🤝 AI Access & Webhooks** *(Pro)* — Let Claude or ChatGPT read your on-phone data during a session you start, open a dashboard on your computer, or push summaries to your own webhook - **🎭 Material 3 Expressive** — Dynamic color, extra colour themes, Google Sans Flex, light/dark/system, and a Home screen you can reorder - **🍎 iOS App** — On the [App Store](https://apps.apple.com/app/id6793073167), with on-device AI chat and Shortcuts automation for bank SMS ### Smart Rules Engine Rules let you auto-categorize, modify, or block transactions based on configurable **conditions**. A rule consists of one or more "When" conditions and a "Then" action. **Available condition fields:** | Field | Description | Example value | Supported operators | |---|---|---|---| | `AMOUNT` | Transaction amount | `200` | `<`, `>`, `=` | | `TYPE` | Income/Expense/Transfer | `INCOME` | `contains`, `equals`, `starts with` | | `CATEGORY` | Assigned category | `Food & Dining` | `contains`, `equals`, `starts with` | | `MERCHANT` | Merchant/vendor name | `Amazon` | `contains`, `equals`, `starts with` | | `NARRATION` | Transaction description | `Monthly rent` | `contains`, `equals`, `starts with` | | `SMS_TEXT` | Raw SMS body | `OTP` | `contains`, `equals`, `starts with` | | `BANK_NAME` | Bank name from SMS | `HDFC Bank` | `contains`, `equals`, `starts with` | | `TIME` / `HOUR` | Transaction time | `09:00` / `9` | `before`, `after`, `at or after`, `at or before` | | `DAY_OF_WEEK` | Day (1=Mon .. 7=Sun) | `1` | `is`, `is any of`, `is not` | | `DAY_OF_MONTH` | Day of month (1-31) | `15` | `is`, `is any of`, `before`, `after` | | `DATE` | Transaction date | `2026-03-21` | `is`, `before`, `after` | | **`ACCOUNT`** | **Bank account composite** | Select from picker | `is`, `is not` | **Account condition (ACCOUNT)** — Restricts the rule to transactions from a specific bank account. The value is stored as a `BankName||Last4` composite key (e.g. `HDFC Bank||1234`). When selected, the UI shows an account picker populated from your tracked accounts. Only `EQUALS` and `NOT_EQUALS` operators are available. Conditions can be combined with **AND** / **OR** logic, and multiple conditions per rule are supported. **Available actions:** - **Set** — Override a field (category, merchant, type, description) - **Append / Prepend** — Add text to a field (merchant, description) - **Clear** — Remove a field value - **Block** — Prevent the transaction from being saved **JSON representation** (stored locally, not exposed via API): ```json { "conditions": [ {"field": "ACCOUNT", "operator": "EQUALS", "value": "HDFC Bank||1234"}, {"field": "AMOUNT", "operator": "GREATER_THAN", "value": "500"} ], "actions": [ {"field": "CATEGORY", "actionType": "SET", "value": "Food & Dining"} ] } ``` ## Supported Banks & Countries Supporting **178 banks & services** across **26 countries** with **multi-currency** capabilities: ### 🇮🇳 India — INR ₹ (58) **AU Small Finance Bank**, **Airtel Payments Bank**, **Amazon Pay**, **American Express**, **Axis Bank**, **Bandhan Bank**, **Bank of Baroda**, **Bank of India**, **CRED**, **Canara Bank**, **Cashfree**, **Central Bank of India**, **City Union Bank**, **DBS Bank**, **Department of Post**, **Dhanlaxmi Bank**, **Equitas Small Finance Bank**, **Federal Bank**, **Greater Bank**, **HDFC Bank**, **HDFC Mutual Fund**, **HSBC Bank**, **ICICI Bank**, **IDBI Bank**, **IDFC First Bank**, **India Post Payments Bank**, **Indian Bank**, **Indian Overseas Bank**, **IndusInd Bank**, **JK Bank**, **Jana Small Finance Bank**, **Jio Payments Bank**, **JioPay**, **Jupiter**, **Karnataka Bank**, **Kerala Bank**, **Kerala Gramin Bank**, **Kotak Bank**, **LazyPay**, **NSDL Payments Bank**, **Navi Mutual Fund**, **OneCard**, **PhonePe Wallet**, **Pluxee**, **Punjab & Sind Bank**, **Punjab National Bank**, **SVC Co-operative Bank**, **Saraswat Co-operative Bank**, **Slice**, **South Indian Bank**, **Standard Chartered Bank**, **State Bank of India**, **Suryoday Small Finance Bank**, **Tamilnad Mercantile Bank**, **UCO Bank**, **Union Bank of India**, **Utkarsh Bank**, **Yes Bank** ### 🇳🇵 Nepal — NPR ₨ (13) **Citizens Bank**, **Everest Bank**, **Laxmi Sunrise Bank**, **Lumbini Bikash Bank**, **Machchhapuchchhre Bank**, **Manjushree Finance**, **NMB Bank**, **Nabil Bank**, **Nepal Bank Limited**, **Nepal SBI Bank**, **Prime Commercial Bank**, **Siddhartha Bank**, **Standard Chartered Bank Nepal** ### 🇹🇭 Thailand — THB ฿ (11) **BAAC**, **Bangkok Bank**, **CIMB Thai**, **Government Savings Bank**, **KTC**, **Kasikorn Bank**, **Krungsri**, **Krungthai Bank**, **Siam Commercial Bank**, **TTB**, **UOB Thailand** ### 🇺🇸 United States — USD $ (10) **ALECU**, **AdelFi**, **Altana Federal Credit Union**, **Charles Schwab**, **Chase**, **Citi Bank**, **Discover Card**, **Huntington Bank**, **Navy Federal Credit Union**, **Old Hickory Credit Union** ### 🇪🇹 Ethiopia — ETB ብር (9) **Apollo**, **Awash Bank**, **Bank of Abyssinia**, **Commercial Bank of Ethiopia**, **Dashen Bank**, **Siket Bank**, **Telebirr**, **ZamZam Bank**, **Zemen Bank** ### 🇳🇬 Nigeria — NGN ₦ (9) **Access Bank**, **GTBank**, **Jaiz Bank**, **Keystone Bank**, **Moniepoint**, **Opay**, **Standard Chartered Bank Nigeria**, **VFD Microfinance Bank**, **Zenith Bank** ### 🇸🇦 Saudi Arabia — SAR ﷼ (9) **Al Rajhi Bank**, **Alinma Bank**, **Banque Saudi Fransi**, **Barq**, **D360 Bank**, **Mobily Pay**, **SABB**, **STC Bank**, **Saudi National Bank** ### 🇹🇿 Tanzania — TZS TSh (7) **CRDB Bank**, **Diamond Trust Bank**, **M-Pesa Tanzania**, **Mixx by Yas**, **NMB Bank Tanzania**, **Selcom Pesa**, **Tigo Pesa** ### 🇦🇪 UAE — AED د.إ (7) **Abu Dhabi Commercial Bank**, **Dubai First**, **Emirates Islamic**, **Emirates NBD**, **First Abu Dhabi Bank**, **Liv Bank**, **Mashreq Bank** ### 🇮🇷 Iran — IRR ﷼ (6) **Bankino**, **Mellat Bank**, **Melli Bank**, **Parsian Bank**, **Pasargad Bank**, **blu Bank** ### 🇧🇩 Bangladesh — BDT ৳ (5) **BRAC Bank**, **City Bank (Bangladesh)**, **IFIC Bank (Bangladesh)**, **Standard Chartered Bank (Bangladesh)**, **bKash** ### 🇯🇴 Jordan — JOD JD (5) **Bank al Etihad**, **Islamic International Arab Bank**, **Jordan Islamic Bank**, **Orange Money**, **Safwa Islamic Bank** ### 🇱🇰 Sri Lanka — LKR Rs (5) **Commercial Bank of Ceylon**, **National Development Bank**, **National Savings Bank**, **Nations Trust Bank**, **Sampath Bank** ### 🇲🇿 Mozambique — MZN MT (4) **M-Pesa Mozambique**, **Millennium BIM**, **Standard Bank Mozambique**, **eMola** ### 🇪🇬 Egypt — EGP E£ (3) **Arab Bank**, **CIB Egypt**, **National Bank of Egypt** ### 🇸🇻 El Salvador — USD $ (3) **Banco Agricola**, **Banco Cuscatlan**, **Banco Promerica** ### 🇧🇾 Belarus — BYN Br (2) **Belarusbank**, **Priorbank** ### 🇪🇺 Eurozone — EUR € (2) **BPCE**, **Sparkasse Rhein-Maas** ### 🇰🇪 Kenya — KES Ksh (2) **Equity Bank**, **M-PESA** ### 🇬🇧 United Kingdom — GBP £ (2) **Chase UK**, **Trading 212** ### 🇨🇴 Colombia — COP $ (1) **Bancolombia** ### 🇨🇿 Czech Republic — CZK Kč (1) **mBank CZ** ### 🇴🇲 Oman — OMR ر.ع. (1) **Bank Muscat** ### 🇵🇰 Pakistan — PKR ₨ (1) **Faysal Bank** ### 🇷🇺 Russia — RUB ₽ (1) **T-Bank** ### 🇹🇷 Turkey — TRY ₺ (1) **Enpara** More banks being added regularly! [Request your bank →](https://github.com/sarim2000/pennywiseai-tracker/issues/new?template=bank_support_request.yml) ## Privacy First All AI processing happens on your device, powered by Google AI Edge LiteRT-LM running Qwen 2.5. Your SMS and transactions are parsed, stored, and analyzed **locally** — there are no accounts, **no analytics, crash-reporting, or telemetry SDKs** (no Firebase / Crashlytics / Sentry / Google Analytics — verify in `app/build.gradle.kts`), and no PennyWise server receives your financial data unless you start one of the opt-in features below (reporting a parsing problem, or AI access). The whole codebase is open source (AGPL v3) so every claim below is checkable. ### Network access — every outbound call the app can make 1. **Google Play services** *(Play Store build only)* — Google Play Billing (optional Pro subscription), In-App Updates, and In-App Review. These are Google's SDKs (declared `standardImplementation`), and they do their own background connectivity to Google — this is the most likely source of any "background data" you notice, especially on a single-currency setup. **The [F-Droid](https://f-droid.org/) build strips all three and is fully Google-free.** 2. **Exchange rates** — fetched from `open.er-api.com`. Automatic currency conversion runs **only when you hold more than one currency** (same-currency conversions make no call), but opening the currency picker also fetches the current rate list. Either way the request carries just a 3-letter currency code and a static `User-Agent` — no SMS, transactions, or device identifier — and results are cached locally. (`ExchangeRateProvider.kt`) 3. **On-device AI model** — a one-time ~1.5 GB download from Cloudflare R2, **only if you open the AI chat and choose to download it**. The bytes are SHA-256 pinned; after that the AI runs 100% offline. (`Constants.MODEL_URL`) 4. **Report a parsing problem** — when you use this flow it opens `pennywise.zynth.dev` with the SMS text, its sender, and an RSA-encrypted device identifier (your Android ID plus a timestamp) pre-filled, and parses them server-side to show a preview. Nothing is sent unless you start this yourself. (`SmsReportUrlBuilder.kt`, `DeviceEncryption.kt`) 5. **Online voice in chat** *(optional, off until you agree)* — dictation runs on your phone's speech service, on-device by default. A language your phone can't recognize offline (e.g. Arabic) can be used online after a one-time prompt that names the service; your speech then goes to that service, not to PennyWise. No audio is recorded or kept. (`VoiceInput.kt`) 6. **AI access** *(Pro, off until you connect an app)* — while an AI session you started is on, questions from Claude, ChatGPT or the PennyWise dashboard reach your phone through the PennyWise relay (`ai.pennywise.zynth.dev`, or your own self-hosted relay); your phone answers from its database. The relay terminates TLS, so it could read those answers; it is built never to store or log them, and you can run your own instead, and SMS text, full account numbers and notes never leave. See [docs/ai-access.md](docs/ai-access.md). 7. **Webhook sync** *(Pro, off unless you add one)* — sends the data you choose (summary, transactions, budgets, accounts, subscriptions) to a URL you enter. (`WebhookDeliveryService.kt`) 8. **Links** (Discord, GitHub, Play Store, user guide, backup docs) open your browser — no background data. Everything else stays on your phone. ## Screenshots

In-app screenshots (light & dark themes)
**Light Theme**
Home Analytics Categories Details AI Chat
**Dark Theme**
Home Analytics Account Detail Accounts AI Chat
## Quick Start ```bash # Clone repository git clone https://github.com/sarim2000/pennywiseai-tracker.git cd pennywiseai-tracker # Environment check + fast test gate (same compile/test tasks CI runs) ./init.sh # Build APK ./gradlew assembleDebug # Install adb install app/build/outputs/apk/standard/debug/app-standard-universal-debug.apk ``` ### Requirements - Android 8.0+ (API 26) - Android Studio Ladybug or newer - JDK 21 ## Tech Stack


**Architecture**: MVVM • Jetpack Compose • Room • Coroutines • Hilt • WorkManager • Google AI Edge LiteRT-LM (on-device LLM) • Material 3 Expressive **Modules**: `app` (Android) • `parser-core` (pure-Kotlin bank SMS parsers) • `shared` (Kotlin Multiplatform) • `iosApp` • `pennywise-web` (site & user guide) • `relay` (AI access relay) ## PennyWise Pro Pro unlocks unlimited custom rules, unlimited PDF statement imports, unlimited CSV export, duplicate-account merge, scheduled daily backups, AI access (Claude, ChatGPT and the dashboard) and webhook sync. It's how a solo developer keeps adding banks and features. **Buy it on the website: [pennywise.zynth.dev/pro](https://pennywise.zynth.dev/pro)** — ₹2,000 lifetime, ₹699/year or ₹149/month, GST included, cards and UPI accepted. You get a license key by email; in the app open **Settings → PennyWise Pro → Have a license key?** and paste it. One phone at a time; restoring a full PennyWise backup on a new phone carries Pro over, and the key dialog offers "Move to this device" for everything else (Play build 2.20.0+). - **Google Play**: in-app purchase is currently unavailable (payments-profile verification on Google's side). Existing Play purchases keep working; new buyers use the website key. - **F-Droid / IzzyOnDroid**: every Pro feature is already unlocked, free. Buying a key there is purely a way to support the project (and it works on the Play build too). ## Community & Support - **User guide**: Step-by-step walkthroughs, troubleshooting, and search — [pennywise.zynth.dev/guide](https://pennywise.zynth.dev/guide) - **Discord**: Join the community, share feedback, and get help — [Join Discord](https://discord.gg/H3xWeMWjKQ) - **Issues**: Report bugs or request features — [Open an issue](https://github.com/sarim2000/pennywiseai-tracker/issues) ## Contributing See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before participating. ```bash ./init.sh # Format check, compile and test (CI also assembles the APK and runs lint) ./init.sh parser # Just parser-core, when you only touched a bank parser ./gradlew :app:lintStandardDebug # Android Lint, as CI runs it ``` ## Security Please review our [Security Policy](SECURITY.md) for how to report vulnerabilities. ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Lucifer1590
Lucifer1590

👥 🐛 📓
akshaynexus
akshaynexus

💻
WINDY-WINDWARD
WINDY-WINDWARD

💻
brukberhane
brukberhane

💻
KaushalJyanni
KaushalJyanni

💻
cmazwar
cmazwar

💻
AyonPal
AyonPal

💻
rafi-ghanbari
rafi-ghanbari

💻
Chevindu
Chevindu

💻
arunpdl
arunpdl

💻
hegdenischay
hegdenischay

💻
shreyes-shalgar
shreyes-shalgar

🐛
test2a
test2a

🐛
AlphaXyph
AlphaXyph

🐛
kamranbahrami261-beep
kamranbahrami261-beep

🐛
jerryn70
jerryn70

🐛
albert-godinho
albert-godinho

🐛
Mikcharls311
Mikcharls311

🐛
rhsjudb
rhsjudb

🐛
xRahul
xRahul

💻
haithamassoli44
haithamassoli44

💻 🌍
khushalmajoka
khushalmajoka

💻
paul-tharun
paul-tharun

💻
chikaezeani
chikaezeani

💻
8valet
8valet

💻
tashifkhan
tashifkhan

💻
gingerjoos
gingerjoos

💻
dhruvitdiyora
dhruvitdiyora

💻
Vijayabaskar56
Vijayabaskar56

💻
Reputable2772
Reputable2772

💻
IndrajeetGhatge
IndrajeetGhatge

💻
FaintFlower
FaintFlower

💻
Ash-jib-home
Ash-jib-home

🐛
EzraTD12
EzraTD12

🐛
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! ## Star History [![Star History Chart](https://star-history.dera.page/svg?repos=sarim2000/pennywiseai-tracker&type=Date)](https://star-history.dera.page/#sarim2000/pennywiseai-tracker&type=date) ## License GNU Affero General Public License v3.0 - see [LICENSE](LICENSE) This project is licensed under AGPL v3, which means: - ✅ You can use, modify, and distribute this software - ✅ You must share your modifications under the same license - ✅ If you run a modified version on a server, you must make the source code available to users - ✅ Patent rights are explicitly granted and protected ---

Download • iOS App • Report Bug • Request Feature