ritesh-kanwar/Cashiro — Gitpedia

Cashiro — Free & Open‑Source, private SMS‑powered expense tracker

Cashiro is a comprehensive financial tracking manager that Turn bank SMS and PDF Statements into a clean, searchable money timeline with on-device AI assistance. 100% private, no cloud processing.

⭐ Star us on GitHub

Overview

For Android users worldwide who want a comprehensive financial tracking — automatic expense tracking from bank SMS, manual cash entry, budgeting, clean categories, subscription detection, and clear insights. Supporting 80+ banks across 14 countries with multi-currency capabilities.

How it works

Grant SMS permission (read‑only). No inbox changes, no messages sent OR import PDF Statements.
Cashiro parses transaction SMS or PDF, extracts amount, merchant, category, and date.
View analytics, subscriptions, and the full transaction timeline — with on-device AI assistant for insights.

Why Cashiro

🤖 Smart SMS Parsing - Automatically extracts transaction details from 40+ banks SMS across 5 countries
🗂️ Smart PDF Parsing - Automatically extracts transaction details from GPay and PhonePe PDF UPI Statements.
💰 Smart Budgeting - Set and track monthly budgets with visual progress indicators
👛 Cash Wallet - Dedicated default wallet for tracking cash expenses
🏦 Advance Account Management - Create Custom account for manual tracking
📂 Advanced Categories - Create and manage custom categories and subcategories
📈 Advanced Visualizations - Interactive animated Line, Bar, and Heatmap graphs
👤 User Profiles - Support for personal user profiles
🔔 Smart Notifications - Alerts and reminders for important financial events
🌍 Multi-Currency Support - Native support for ₹, $, د.إ, ₨, ብር with proper localization
📊 Clear Insights - Analytics and charts to instantly see where money goes
🔄 Subscription Tracking - Detects and monitors recurring payments
💬 On-device AI Assistant - Ask questions like "What did I spend on food last month?" locally
📤 Data Export - Export as CSV for taxes or records

Supported Banks & Countries

Supporting 80+ banks across 14 countries with multi-currency capabilities:

🇮🇳 India (40+ banks) - INR ₹

HDFC Bank, State Bank of India (SBI), ICICI Bank
Axis Bank, Punjab National Bank (PNB), IDBI Bank
Indian Bank, Federal Bank, Karnataka Bank, Kerala Gramin Bank
Canara Bank, Bank of Baroda, Bank of India, Union Bank
Jupiter (CSB Bank), Amazon Pay (Juspay), Kotak Bank
IDFC First Bank, HSBC Bank, Central Bank of India
South Indian Bank, JK Bank, Indian Overseas Bank
Airtel Payments Bank, AMEX, IPPB, DOP (Post Office)
OneCard, UCO Bank, AU Bank, Yes Bank, Bandhan Bank
IndusInd Bank, City Union Bank, Dhanlaxmi Bank, Standard Chartered
Equitas Small Finance Bank, Saraswat Bank, DBS Bank, Utkarsh Bank
Services: Slice, LazyPay, Jio Pay, Juspay

🇺🇸 USA (7 banks) - USD $

Citi Bank, Discover Card, Old Hickory Credit Union, Charles Schwab
Navy Federal Credit Union, AdelFi Credit Union, Huntington Bank

🇦🇪 UAE (5 banks) - AED د.إ

First Abu Dhabi Bank (FAB), Abu Dhabi Commercial Bank (ADCB)
Emirates NBD, Liv Bank, Mashreq Bank

🇳🇵 Nepal (7 banks) - NPR ₨

Laxmi Sunrise Bank, Everest Bank, NMB Bank, Nabil Bank
Manjushree Finance, Siddhartha Bank, Prime Commercial Bank

🇹🇭 Thailand (11 banks/cards) - THB ฿

Bangkok Bank, Kasikorn Bank, Siam Commercial Bank, Krungthai Bank
Krungsri (Bank of Ayudhya), TMBThanachart (TTB), Government Savings Bank (GSB)
BAAC, UOB Thailand, CIMB Thai, KTC Credit Card

🇪🇹 Ethiopia (4 banks/services) - ETB ብር

Commercial Bank of Ethiopia (CBE), Telebirr, Zemen Bank, Dashen Bank

🇹🇿 Tanzania (3 services) - TZS TSh

M-Pesa Tanzania, Selcom Pesa, Tigo Pesa (Mixx by Yas)

🇵🇰 Pakistan (2 banks) - PKR ₨

Faysal Bank, Standard Chartered Bank

🇮🇷 Iran (2 banks) - IRR ﷼

Melli Bank, Parsian Bank

🇸🇦 Saudi Arabia (1 bank) - SAR ﷼

Alinma Bank (بنك الإنماء) - Arabic SMS support

🇪🇬 Egypt (1 bank) - EGP E£

CIB (Commercial International Bank)

🇰🇪 Kenya (1 service) - KES Ksh

M-PESA - Mobile money service

🇨🇴 Colombia (1 bank) - COP $

Bancolombia

🇧🇾 Belarus (1 bank) - BYN Br

Priorbank - Russian/Belarusian SMS support

More banks being added regularly! Request your bank →

Privacy First

All processing happens on your device using MediaPipe's LLM. Your financial data never leaves your phone. No servers, no uploads, no tracking.

Screenshots

<table> <tr> <td><img src="screenshots/home.png" width="160"/></td> <td><img src="screenshots/analytics.png" width="160"/></td> <td><img src="screenshots/chat.png" width="160"/></td> <td><img src="screenshots/settings.png" width="160"/></td> </tr> <tr> <td align="center">Home</td> <td align="center">Analytics</td> <td align="center">AI Chat</td> <td align="center">Settings</td> </tr> <tr> <td><img src="screenshots/subscriptions.png" width="160"/></td> <td><img src="screenshots/transactions.png" width="160"/></td> <td><img src="screenshots/account_detail.png" width="160"/></td> <td><img src="screenshots/categories.png" width="160"></td> </tr> <tr> <td align="center">Subscriptions</td> <td align="center">Transactions</td> <td align="center">Account Details</td> <td align="center">Categories</td> </tr> <tr> <td><img src="screenshots/budgets.png" width="160"/></td> <td><img src="screenshots/budget_details.png" width="160"/></td> <td><img src="screenshots/budget_history.png" width="160"/></td> <td><img src="screenshots/profile.png" width="160"></td> </tr> <tr> <td align="center">Budgets</td> <td align="center">Budget Details</td> <td align="center">Budget History</td> <td align="center">Profile</td> </tr> </table>

Quick Start

bash
# Clone repository
git clone https://github.com/ritesh-kanwar/Cashiro.git
cd Cashiro

# Build APK
./gradlew assembleDebug

# Install
adb install app/build/outputs/apk/debug/app-debug.apk

Requirements

Android 8.0+ (API 26)
Android Studio Ladybug or newer
JDK 11

Tech Stack

Architecture: MVVM • Jetpack Compose • Room • Coroutines • Hilt • MediaPipe AI • Material Design 3

Project Structure

The app follows a modern Android architecture guideline, separating concerns into Data, Domain, and Presentation layers.

com.ritesh.cashiro
├── data                # Data layer (Repositories, Room Database, Data Sources)
│   ├── database        # Room entities and DAOs
│   ├── repository      # Repository implementations
│   ├── manager         # SMS and Notification managers
│   └── preferences     # DataStore preferences
├── domain              # Domain layer (Use Cases, Models)
├── presentation        # UI layer (Jetpack Compose)
│   ├── ui              # Composable screens and components
│   │   ├── features    # Feature-specific screens and viewmodels (Transactions, Budget, etc.)
│   │   └── components  # Reusable UI components
│   └── navigation      # Navigation graph and destinations
├── di                  # Dependency Injection (Hilt Modules)
└── utils               # Utility classes and extensions

Community & Support

Issues: Report bugs or request features — Open an issue

Contributing

See CONTRIBUTING.md for guidelines.

Please read our Code of Conduct before participating.

bash
./gradlew test          # Run tests
./gradlew lint   # Check style

Security

Please review our Security Policy for how to report vulnerabilities.

Contributors ✨

This project follows the all-contributors specification. Contributions of any kind welcome!

Acknowledgements

Special thanks to the following projects and resources:

PennyWise AI - The base and inspiration of this project.
Microsoft Fluent Emojis - Beautiful emojis used for category icons.
Haze - Applied for stunning blur effects.
Compose Charts - Used for creating animated charts and graphs.
Reorderable - Used for re-ordering widgets.
Peeps Ui8 - Used for Built-in User Avatars.
Iconax - Used for icons

License

GNU General Public License v3.0 - see LICENSE

<p align="center"> <a href="https://github.com/ritesh-kanwar/Cashiro/releases">Download</a> • <a href="https://github.com/ritesh-kanwar/Cashiro/issues">Report Bug</a> • <a href="https://github.com/ritesh-kanwar/Cashiro/issues">Request Feature</a> </p>