FinTrack - LLM based finance tracker

FinTrack is a LLM integrated personal finance tracker mobile application that allows users to monitor their online and offline expenses from various connected accounts in one place. This repository contains both the frontend mobile application built with React Native and the backend server built with Node.js.

Plaid.Walkthrough.mp4

Features

• Expense Tracking: Track all your expenses in one place, categorized and summarized for easy review.
• Bank Account Integration: Link your bank accounts using Plaid API to automatically import transactions.
• LLM Integration: Access the power of LLM in order to get personalised insights, summaries and more by simply asking the question to your data.
• Receipt Scanning: Use OCR technology to scan and digitize receipts.
• Analytics: View detailed spending analytics and insights.
• User Authentication: Secure login and registration with biometric authentication support.

Table of Contents

• Getting Started
  • Prerequisites
  • Installation
  • Running the App
• Project Structure
• Technologies Used
• Contributing
• License

Getting Started

Prerequisites

• Node.js
• npm or yarn
• Expo CLI
• Android Studio / Xcode (for mobile app development)

Installation

1. Clone the repository:

   git clone https://github.com/yashsoni27/FinTrack.git
   cd FinTrack

2. Install dependencies for the mobile app:

   cd FinTrack
   npm install

3. Install dependencies for the server:

   cd server
   npm install

Running the app

1. Setup

   • Make sure you all the necessary android SDK installed
   • Also if developing on local device then alongside Expo Go, your device should be in Developer mode and USB debugging should be enabled
   • Then after connecting the device via cable, run this command beforehand

   adb reverse tcp:8000 tcp:8000

2. Start the backend server:

   cd server
   npm start

3. Run the mobile app:

   cd..
   npx expo run:android

Project Structure

Frontend (Mobile App)

• src/: Contains the main codebase for the mobile app
  • components/: Reusable UI components
  • screens/: App screens and navigation setup
  • assets/: Images, icons, etc.
  • services/: API service calls and utility functions
  • navigation/: Navigation setup

Backend (Server)

• controllers/: Handles the logic for different routes
• models/: Mongoose models for MongoDB
• routes/: Express routes
• middlewares/: Custom middleware functions
• config/: Configuration files and constants

Technologies Used

• Frontend:

  • React Native
  • Expo
  • Async Storage
  • Axios

• Backend:

  • Node.js
  • Express.js
  • MongoDB
  • Plaid API
  • Gemini API

Contributing

Contributions are welcome! Please fork the repository and create a pull request with your changes. Make sure to follow the existing code style and include relevant tests for any new functionality.

License

This project is licensed under the MIT License.