Skip to content

arpithpm/expense-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

78 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Receipt Radar πŸ“±

AI-Powered Expense Management Made Simple

Receipt Radar is a sophisticated iOS expense management app that uses cutting-edge AI technology to automatically extract expense data from receipt photos, making expense tracking effortless and accurate.

Version iOS Swift License

✨ Features

πŸ€– AI-Powered Receipt Processing

  • Smart OCR Technology: Advanced AI extracts merchant names, amounts, dates, and itemized purchases from receipt photos and PDFs
  • PDF Support: Process digital receipts, email attachments, and scanned documents in PDF format
  • Multi-Currency Support: Recognizes 50+ currencies including USD, EUR, GBP, INR, JPY, and more
  • Regional Format Recognition: Handles different date formats (DD/MM/YYYY, MM/DD/YYYY, DD.MM.YYYY)
  • Multiple File Support: Process multiple photos and PDFs simultaneously
  • Auto-categorization: Intelligent expense categorization based on merchant and purchase patterns

πŸ“Š Comprehensive Expense Management

  • Global Currency Support: Track expenses in 50+ currencies with proper locale formatting
  • Real-time Tracking: Monitor spending across multiple categories and currencies
  • Detailed Analytics: Visual spending insights and monthly breakdowns
  • Export Capabilities: Export data in CSV or JSON formats
  • Intelligent Tax Recognition: Supports regional tax labels (GST, VAT, Sales Tax)

🎨 Modern User Experience

  • SwiftUI Interface: Native iOS design with smooth animations
  • Dark Mode Support: Adaptive interface for all lighting conditions
  • Accessibility: Full VoiceOver and accessibility feature support
  • iPad Compatibility: Optimized for both iPhone and iPad devices

πŸ”’ Privacy & Security

  • Local Data Storage: All expense data stored securely on your device
  • Input Validation: Comprehensive data sanitization and security measures
  • No Data Collection: Your financial information never leaves your device
  • Secure AI Processing: Receipt processing through encrypted OpenAI API calls

πŸš€ Getting Started

Prerequisites

  • iOS 15.0 or later
  • iPhone or iPad
  • OpenAI API key (for AI-powered receipt processing)

Installation

  1. Clone this repository
  2. Open ExpenseManager.xcodeproj in Xcode
  3. Build and run on your iOS device or simulator

Configuration

  1. Launch the app
  2. Navigate to Settings β†’ Configuration
  3. Enter your OpenAI API key
  4. Test the connection to ensure proper setup

πŸ“± How to Use

Processing Receipts

  1. Select Files: Tap the selection button to choose receipt photos or PDF documents
  2. Multiple Formats: Upload photos from camera/gallery or PDF files from email/storage
  3. AI Processing: The AI automatically extracts expense details from images and PDFs
  4. Review: Verify the extracted information and make any necessary edits
  5. Save: Add the expense to your tracking system

Managing Expenses

  • View All Expenses: Browse your complete expense history
  • Search & Filter: Find specific expenses by merchant, category, or date
  • Edit Details: Modify any expense information as needed
  • Delete Expenses: Remove unwanted or duplicate entries

Analytics & Insights

  • Spending Overview: Visual breakdown of expenses by category
  • Monthly Trends: Track spending patterns over time
  • Export Data: Generate reports in CSV or JSON format
  • Budget Tracking: Monitor spending against your financial goals

πŸ›  Technical Architecture

Core Technologies

  • SwiftUI: Modern declarative UI framework
  • Core Data: Local data persistence and management
  • PhotosUI: Native photo selection and processing
  • OpenAI GPT-4: Advanced AI for receipt text extraction
  • Combine: Reactive programming for data flow management

Key Components

  • CoreDataExpenseService: Central expense management and persistence
  • OpenAIService: AI-powered receipt processing
  • InputValidator: Comprehensive input validation and sanitization
  • DataExporter: Multi-format data export capabilities
  • ConfigurationManager: Secure API key and settings management

Data Security

  • Input Sanitization: All user inputs validated and sanitized
  • Secure Storage: Keychain integration for sensitive data
  • Privacy Controls: Full user control over data sharing and exports
  • Encryption: Secure API communications with OpenAI services

πŸ“‹ System Requirements

  • iOS Version: iOS 15.0 or later
  • Device: iPhone 8 or newer, iPad (6th generation) or newer
  • Storage: Minimum 50 MB available space
  • Network: Internet connection required for AI processing
  • Camera: Device camera for receipt photo capture

πŸ”§ Configuration

OpenAI Integration

Receipt Radar uses OpenAI's GPT-4 model for intelligent receipt processing. To configure:

  1. Obtain an API key from OpenAI
  2. Open Receipt Radar β†’ Settings β†’ Configuration
  3. Enter your API key and test the connection
  4. Enjoy automated expense extraction!

Privacy Settings

  • All data processing happens locally on your device
  • OpenAI API calls are encrypted and temporary
  • No personal data is stored on external servers
  • You maintain full control over your financial information

🌍 Multi-Currency Support

Receipt Radar now supports 50+ currencies worldwide, making it perfect for international travelers and global businesses:

Supported Currencies

  • Americas: USD, CAD, MXN, BRL, ARS, CLP, COP, PEN, UYU
  • Europe: EUR, GBP, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, HRK, RSD
  • Asia-Pacific: INR, JPY, CNY, SGD, HKD, AUD, NZD, MYR, THB, IDR, PHP, VND, KRW, TWD
  • Middle East & Africa: AED, SAR, QAR, KWD, BHD, OMR, ILS, TRY, EGP, ZAR, NGN, KES, GHS
  • Others: RUB, UAH, KZT, UZS

Currency Features

  • Smart Recognition: Automatically detects currency symbols (β‚Ή, €, Β£, Β₯, $, etc.)
  • Locale Formatting: Proper currency display based on regional standards
  • Regional Tax Support: Recognizes GST (India), VAT (Europe), Sales Tax (US)
  • Date Format Intelligence: Handles DD/MM/YYYY, MM/DD/YYYY, DD.MM.YYYY formats

πŸ“Š Export Formats

CSV Export

  • Compatible with Excel and Google Sheets
  • Includes all expense details, categories, and currencies
  • Perfect for accounting software integration

JSON Export

  • Structured data format for developers
  • Complete metadata, categorization, and currency information
  • Ideal for custom analysis and integration

πŸ”„ Data Migration

Receipt Radar automatically handles data migration between versions:

  • Seamless Upgrades: Automatic migration from UserDefaults to Core Data
  • Backup Preservation: Your data is safely preserved during updates
  • Compatibility: Forward and backward compatibility maintained

🀝 Contributing

We welcome contributions to Receipt Radar! Please feel free to submit pull requests, report issues, or suggest new features.

Development Setup

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ“ž Support

For support, feature requests, or bug reports:

πŸ™ Acknowledgments

  • OpenAI for providing the GPT-4 API for receipt processing
  • Apple for the excellent SwiftUI and Core Data frameworks
  • The iOS development community for inspiration and support

πŸ—Ί Roadmap

Upcoming Features

  • Team Collaboration: Shared expense management for businesses
  • Receipt Templates: Custom receipt processing for specific merchants
  • Budget Alerts: Smart notifications for spending limits
  • Siri Integration: Voice-controlled expense entry
  • Currency Conversion: Real-time exchange rates for multi-currency portfolios

Receipt Radar - Making expense management intelligent, secure, and effortless.

Built with ❀️ for iOS

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages