aindilis / financial-planning

A temporal metric financial PDDL planning domain and problem w/ tools for personal planning. Extremely simple proof of concept to be expanded upon.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

๐Ÿ’ฐ Financial Planner - Your AI-Powered Personal Finance Assistant ๐Ÿค–

Welcome to the Financial Planner, a key component of the Free Life Planner (FLP) system. This intelligent AI-based tool is designed to help you take control of your personal finances, plan for the future, and achieve your financial goals.

๐ŸŒŸ Features

The Financial Planner offers a wide range of features to assist you in managing your money:

  • ๐Ÿง  Intelligent Financial Planning and Reasoning: Leveraging advanced AI techniques, the planner integrates action costs and earning information to generate comprehensive temporal plans for financial prediction and reasoning.

    • โœ… Quickly forecast finances almost indefinitely into the future
    • โœ… Specify recurring transactions
    • โœ… Automatically detect recurring transactions from OFX exports and plan for them (e.g., promiseToPayForSpec('ELEC',andrewDougherty,'',dollars(93.00),[can([1]),not(onTime([3]))]))
    • โœ… Express expected date ranges of transactions using can, neg(onTime), months, date ranges, etc.
    • โœ… Financial reasoning integrated with general planning, adding financial reasoning to life-planning problems
  • ๐Ÿ–ฅ๏ธ Interactive Plan Execution: The intuitive GUI guides you through the execution of your financial plan, checking preconditions, propagating effects, and helping you stay on track.

    • โœ… IEM2 for walking user through plans
    • โœ… Update world state with all effects
    • โœ… Extraction of world state deltas
    • ๐Ÿšง [50%] Verify preconditions
    • ๐Ÿšง [25%] WebUI for IEM2 (using Mock Perl/Tk objects)
    • ๐Ÿšง [75%] SPSE2->PSEx3 export (Planning, Scheduling and Execution System (Extended), version 3)
    • ๐Ÿšง [75%] Integrating financial reasoning and other domains, with SPSE's to-do dependency graph
  • ๐Ÿ“… Calendaring and Recurrences: View your predicted transactions, running balances, and upcoming financial events in a clear calendar format. The system also supports programmable recurrences and can detect patterns from your transaction logs.

    • โœ… View expected financial transactions along with primary agenda on a calendar
    • โœ… Calenderical recurrences using CLP (Constraint Logic Programming)
    • โœ… Predicted transactions' date, description, debit or credit and running balance (as a list and chart)
    • โœ… Tell us when we're going to run out of money and how much we need to raise by when
    • โœ… Abduction of recurrences and predicted events from bank statements in OFX or CSV (Open Financial Exchange, Comma-Separated Values)
    • โœ… Text-to-speech alerts for recurrent transactions
    • ๐Ÿšง [25%] WebUI for editing financial recurrences
  • ๐Ÿ“Š Financial Records and Order Tracking: Automatically extrapolate auto-debits from bank exports, reconcile records with reported purchases, and track the state of your deliveries.

    • โœ… Matching bank records to receipts
    • โœ… Tracking purchases and deliveries
    • ๐Ÿšง [50%] Online receipt tracker
    • ๐Ÿšง [50%] Brick and mortar receipt tracker
    • ๐Ÿšง [10%] Displaying live/real-time bank information
    • ๐Ÿšง [20%] Check current account balance automatically

๐Ÿ”ฎ Planned Features

We're constantly working to improve the Financial Planner. Here are some exciting features in the pipeline:

  • ๐Ÿ’ธ Cash Flow Analysis and Budgeting: The planner will help you compute a monthly budget and set goals to build up your financial safety buffer.

    • โœ… Help manage cash flow in tight situations
    • ๐Ÿšง Budgeting (monthly)
    • ๐Ÿšง Automatic creation of fundraising alerts and deadlines to maintain positive balance
    • ๐Ÿšง Classifying (OFX) transactions
    • ๐Ÿšง Financial reporting
    • ๐Ÿšง Regulatory compliance (say, to Social Security rules)
    • ๐Ÿšง (Personal) Accounting with XBRL bookkeeping
    • ๐Ÿšง Loan and debt tracking/management
    • ๐Ÿšง Bill payment subsystem
  • ๐Ÿงฉ Meta-Planning for Contingencies: Advanced planning capabilities will allow the system to develop contingent plans, helping you prepare for various financial scenarios.

    • โœ… Temporal metric planning for finances
    • โœ… Unexpected delays
    • ๐Ÿšง Metaplanners help develop contingency plans for different financial problems
    • ๐Ÿšง TraCE temporally-contingent (metric) planner integration
    • ๐Ÿšง Overcharges and unapproved charges
    • ๐Ÿšง Cash flow problems and hardships
    • ๐Ÿšง Retrospectively analyze prior predictions to update or correct financial recurrences
  • ๐Ÿค Argumentation-Based Purchase Decisions: The planner will reason about your needs and help you make informed, ethical purchasing decisions that align with your budget and values.

    • ๐Ÿšง Purchase Decision Support System / Broker Buy/Sell System
    • ๐Ÿšง Oversubscription planning for maximizing utility given a cost bound, when can't accomplish all goals
    • ๐Ÿšง [05%] Oversubscription Planning using Sym-Osp
    • ๐Ÿšง Argumentation-based PDSS (Purchase Decision Support System)
      • ๐Ÿšง Reasoning over user needs
      • ๐Ÿšง Critical questions: Is this purchase ethical/necessary/within-budget? The assumption is "do not purchase," which must be soundly defeated to gain permission
      • ๐Ÿšง Product and seller comparison
      • ๐Ÿšง Payment plan management
    • ๐Ÿšง Inventory/pantry Inventory Management integration
    • ๐Ÿšง Resource manager (automatic reordering and stock management)

๐Ÿš€ Getting Started

For more information, please see the Financial Planner section of the FLP Reference Manual: FLP documentation

The financial planner is still being developed, but to start using a very minimal alpha version of the FLP system, follow the instructions present in the Panoply repository.

๐Ÿ‘ฅ Contributing

We welcome contributions from the community to help make the Financial Planner even better. If you'd like to contribute, please drop us a message at adougher9@yahoo.com for more information on how to get started.

๐Ÿ“œ License

The Financial Planner is part of the Free Life Planner system and is released under the GNU General Public License (GPL). See the LICENSE file for more details.

๐Ÿ†˜ Support

If you encounter any issues or have questions about the Financial Planner, please open an issue on our GitHub repository.

Get ready to take control of your financial future soon with FLP's Financial Planner! ๐ŸŽ‰

About

A temporal metric financial PDDL planning domain and problem w/ tools for personal planning. Extremely simple proof of concept to be expanded upon.

License:Other


Languages

Language:Prolog 78.7%Language:Perl 9.4%Language:PDDL 8.9%Language:HTML 1.8%Language:Shell 1.2%