LiberaDebt

A CLI app that takes your monthly financial obligations from an XLSX file and uses Ollama to provide efficient payoff advice.

Pre-requisites

• Ollama must be installed and running via ollama serve

Usage

1. Download the obligations.xlsx template file.
   • Column headers with * are required; others are optional.
   • See obligations_sample.xlsx for an example of how to populate the data.
2. Fill out the XLSX sheet with one row per monthly obligation (recurring bills, loan payments, lifestyle expenses, credit card payments, etc.).
   • Include as many obligations as possible (fuel, groceries, etc.) so the AI can accurately determine your available balance.
3. Save the XLSX file in the same directory as the LiberaDebt executable, or specify a custom path with the -data argument.
4. Run the program:
   • Double-click the executable, or
   • Run from the command line with potential for arguments:

     LiberaDebt -data="/custom/path/to/obligations.xlsx" -income="3500"

Optional Command Line Arguments

Argument	Description	Default
-data	Path to your obligations XLSX file. It can be named differently but must use the template provided	./obligations.xlsx (current working directory)
-income	Your monthly income (after taxes & deductions). If not provided, you will be prompted to enter it. Avoid $ if passing an argument since it will be treated as an environment variable. $ is only acceptable if no argument is passed at runtime & you are prompted for an income. ,, and spaces are acceptable regardless.	N/A
-goal	Your custom financial goal. If not different from the default, you will be prompted to confirm or enter a new goal.	Provide a shortest-time payoff plan using any leftover budget for extra payments to loans and/or credit cards
-model	Ollama model to use (see Ollama models)	qwen3:8b
-excludeThink	If true, removes <think>...</think> content from output file	true

 

---

Support This Developer

Single or monthly contributions

• GitHub Sponsors
• Ko-Fi

Crypto currency wallets

• ETH: 0x7531d86D5Dbda398369ec43205F102e79B3c647A
• BTC: bc1qtkuzp85vph7y37rqjlznuta293qsay07cgg90s
• LTC: ltc1q9pquzquaj6peplygqdrcxxvcnd5fcud7x80lh8
• DOGE: DNQ3GHBVEcNpzXNeB7B4sPqd7L1GhUpMg3
• SOL: EQ6QwibvKZsazjvQGJk6fsGW4BQSDS1Zs6Dj79HfVvME