Skip to content

CurioPay is an open-source budget tracking app that uses Large Language Models (LLMs) to provide personalized financial insights. Track your expenses, set budgets, and interact with AI to optimize your spending. Fully customizable, privacy-focused, and easy to deploy locally. Contributions welcome!

License

Notifications You must be signed in to change notification settings

AdhamAfis/curiopay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Curiopay: Open Source Budget Tracking App with LLM Insights

License: MIT Status: Active TypeScript Next.js Tailwind CSS

Curiopay is a free, open-source app for tracking your budget and getting personalized financial insights using AI-powered Large Language Models (LLMs). It helps you track expenses, set budgets, and receive AI-driven advice—all while keeping your data secure with local deployment options.


Key Features

  • Expense Tracking: Log income and expenses with categories and dates.
  • Budget Alerts: Real-time notifications and email alerts when budgets are exceeded.
  • AI Financial Insights: Chat with LLMs for personalized spending advice.
  • Recurring Expenses: Automate daily, weekly, or monthly expense tracking.
  • Data Export: Save data in CSV or JSON formats.
  • Secure and Private: Local deployment ensures complete control of your financial data.

In Progress

  • Responsive mobile-friendly design and themes.
  • Expanded LLM provider support.

Planned

  • Mobile app development.
  • Receipt scanning for automatic expense entry.
  • Advanced analytics like predictive spending trends.

Installation

Prerequisites

  • Node.js (v14+)
  • npm
  • Docker (for local PostgreSQL server)

Quick Setup

  1. Clone the repository:

    git clone https://github.com/adhamafis/curiopay.git  
    cd curiopay  
  2. Run the setup script:

    ./setup.sh  

    The script:

    • Configures environment variables (.env file).
    • Sets up a local PostgreSQL database with Docker.
    • Guides you through API keys and email setup.

Usage

  • Log and categorize your income and expenses.
  • Set budgets and receive alerts if exceeded.
  • Interact with AI for spending insights.
  • Export your data for offline analysis.

Contributing

Contributions are welcome! Here’s how to get started:

  1. Fork and Clone the repository:

    git clone https://github.com/adhamafis/curiopay.git  
    cd curiopay  
  2. Create a new branch:

    git checkout -b feature/new-feature  
  3. Make your changes and commit:

    git commit -am "Add new feature"  
  4. Push and create a pull request.

Every contribution—big or small—makes Curiopay better!


License

Curiopay is licensed under the MIT License.


Contact

For questions or suggestions:
Email: adham.afis@gmail.com

About

CurioPay is an open-source budget tracking app that uses Large Language Models (LLMs) to provide personalized financial insights. Track your expenses, set budgets, and interact with AI to optimize your spending. Fully customizable, privacy-focused, and easy to deploy locally. Contributions welcome!

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Languages