README

About Yaffa

Yaffa is a personal finance web application, focusing on the support of long term financial planning. Yaffa is a self hosted web application, written in PHP, using Laravel framework. By hosting your own app instance, your financial data is not uploaded to the cloud, and shared with any third parties.

Read more about YAFFA at https://yaffa.cc

Key features

• Support multiple currencies.
  • There is a default currency, which is used on dashboards and charts.
  • Currency rates are automatically updated daily.
  • YAFFA utilizes the free Frankfurter service, requiring no API key or registration.
• Support multiple accounts and account groups.
• Track your income and spending by recording transactions.
  • Yaffa tries to come up with suggestions while entering transactions to speed up transaction recording process.
  • Transactions can be split into categories. This helps to better understand spending patterns and budget planning.
  • Yaffa can process documents with AI and prefill transaction details automatically.
    • Supported sources include manual uploads (text/PDF/images), received emails, and Google Drive imports.
    • This feature is optional and currently supports OpenAI or Gemini providers. You need to provide your own API key and billing setup.
    • OCR for images is available via Tesseract (self-hosted) or Vision-capable AI models.
• Scheduled and recurring transactions, and budgets (plans) can be created.
  • This can be used to calculate forecasted data.
  • You can enable the automatic recording of recurring transactions.
• Add your investments, to calculate gain and loss.
  • Automatically retrieve investment prices.
  • This is based on the alphavantage.co service. You need to register and get your free API key.
• Import transactions from QIF and CSV files. Customizable import rules to support country and bank specific formats.

There are several features planned to be implemented:

• Further charts, reports and dashboards.
• Handling multiple users as a family in one app instance.
• Better onboarding experience, or a tutorial.
• YAFFA is not using dedicated libraries for precise decimal calculations for monetary values. As it is not an accounting software, but a personal finance application, this should not be a real problem. It is planned to be implemented in the future, to avoid any potential issues with calculations and currency conversions. In the meantime, be aware, if this is a concern for you.

Several features are not likely to be introduced, which you might expect from such applications. If you are looking to have these in a budget app or expense tracker, then YAFFA might not be the best choice for you.

• Downloading transaction data directly from banks
  • The philosophy of expense tracking is to be conscious about your spending and financial habits, which requires the review and manual adjustment of transactions. Thus, automatic downloading of transactions from banks would save some time, but would not help to achieve the goal of expense tracking and budgeting.
  • Also, YAFFA supports automatic creation of scheduled transactions and entry of simple recurring transactions, to speed up the process of recording transactions.
• Native mobile app
  • YAFFA is optimized for desktop browsers. The interface is responsive to support mobile view, but not fully optimized for mobile devices.

Read more about the features of YAFFA

Try it out

You can try out YAFFA without installing it. Take a look at the application at https://sandbox.yaffa.cc

• Do you want to walk around, kick the tires, and see the application in action? Use the demo account featuring realistic sample data.
• Do you want a full test drive to explore the application as if it were your own instance? You can register a new account at https://sandbox.yaffa.cc/register

⚠️ Important! This is not a production environment or a free service. Use it only to experiment with YAFFA's functionality and UI. The database is regularly wiped without prior notice.

💡 Tip: use a fake or disposable email address to sign up. The email address does not need to be verified.

Getting started

Read the full documentation at https://yaffa.cc/documentation/, including the Getting Started guide and the Installation instructions.

Upgrading

When upgrading between major versions, please see the details and follow the instructions listed in the upgrade guide.

Contributors

Thanks to these people for helping improve this project:

• WMP - Polish translation and various features, including the monthly breakdown and drill down functionality.

License

YAFFA is open-sourced software licensed under the MIT license.