Plutus Lite — Free Expense Preview#

Paste up to 15 expenses and get a quick category breakdown.

Free vs Pro#

FeaturePlutus Lite (Free)Plutus ProTransactions15 maxUnlimitedCSV file input❌✅Budget comparison❌✅Monthly trends❌✅Tax deduction tracking❌✅Savings rate analysis❌✅Spending forecast❌✅ 1-12 monthsExport (CSV + JSON)❌✅

👉 Upgrade: openclaw skills install plutus-pro — key at ko-fi.com/s/83c662001e

💰 Bundle deal: all 5 Pro skills for $29 → ko-fi.com/s/7625accf3f (save $16)

---

Step 1 — Install#

bash

pip3 install rich --break-system-packages --quiet

---

Step 2 — Quick expense scan (Lite)#

python

import os, re
from datetime import date
from collections import defaultdict
from rich.console import Console
from rich.table import Table
from rich.panel import Panel
from rich import box

console = Console()

EXPENSES_TEXT = os.environ.get("EXPENSES_TEXT","").strip()
CURRENCY      = os.environ.get("CURRENCY","USD").upper()
SYM           = {"USD":"$","EUR":"€","GBP":"£"}.get(CURRENCY,"$")
TODAY         = date.today()
TX_LIMIT      = 15

def fmt(a): return f"{SYM}{a:,.2f}"

def parse_amount(raw):
    c = re.sub(r"[^0-9.]","",str(raw)) or "0"
    try: return float(c) if c.count(".")<=1 else None
    except: return None

CATEGORIES = {
    "Food & Dining":  ["coffee","starbucks","restaurant","pizza","burger","cafe","food","doordash","grubhub","grocery","walmart","whole foods"],
    "Transport":      ["uber","lyft","taxi","gas","fuel","parking","transit","bus","train","flight"],
    "Shopping":       ["amazon","ebay","etsy","target","bestbuy","clothing","shoes"],
    "Subscriptions":  ["netflix","spotify","hulu","disney","prime","subscription","membership","software"],
    "Utilities":      ["electric","water","internet","phone","mobile","utility","bill"],
    "Health":         ["pharmacy","doctor","dentist","medical","gym","fitness","cvs","walgreens"],
    "Entertainment":  ["movie","cinema","concert","ticket","game","gaming","book"],
    "Other":          [],
}

def categorise(desc):
    dl = desc.lower()
    for cat, kws in CATEGORIES.items():
        if cat == "Other": continue
        if any(k in dl for k in kws): return cat
    return "Other"

transactions = []

if EXPENSES_TEXT:
    for line in EXPENSES_TEXT.strip().splitlines():
        if len(transactions) >= TX_LIMIT:
            console.print(f"[yellow]⚠️  Lite limit: showing first {TX_LIMIT} transactions. Upgrade to Pro for unlimited.[/yellow]")
            break
        line = line.strip()
        if not line: continue
        tokens = line.split()
        amt = None
        for tok in reversed(tokens):
            a = parse_amount(tok)
            if a is not None: amt = a; break
        if amt is None: continue
        desc_tokens = tokens[:-1] if tokens[-1] == str(amt) else [t for t in tokens if parse_amount(t) != amt]
        # Strip leading date tokens (simple heuristic)
        if len(desc_tokens) >= 2:
            try:
                int(desc_tokens[0]); desc_tokens = desc_tokens[1:]
            except ValueError:
                pass
        description = " ".join(desc_tokens) or "Expense"
        transactions.append({"description": description, "amount": amt, "category": categorise(description)})
else:
    # Demo data
    console.print("[yellow]ℹ️  No EXPENSES_TEXT set — running with demo data.[/yellow]")
    console.print("[dim]Set EXPENSES_TEXT='Coffee 4.50\\nAmazon 34.99\\nUber 18.30' to use your own.\n[/dim]")
    demo = [
        ("Starbucks coffee",5.50),("Uber ride",18.30),("Netflix",15.99),
        ("Groceries Walmart",87.45),("Amazon order",34.99),("Restaurant dinner",62.00),
        ("Gas station",55.00),("Spotify premium",9.99),("CVS pharmacy",22.10),("Gym membership",45.00),
    ]
    for desc,amt in demo:
        transactions.append({"description":desc,"amount":amt,"category":categorise(desc)})

if not transactions:
    console.print("[yellow]No transactions found.[/yellow]")
    raise SystemExit(0)

total_spend = sum(t["amount"] for t in transactions)

console.print()
console.print(Panel.fit(
    f"[bold green]💰 Plutus Lite — Expense Snapshot[/bold green]\n"
    f"Transactions: [yellow]{len(transactions)}/{TX_LIMIT}[/yellow]  Total: [red]{fmt(total_spend)}[/red]\n"
    f"[dim]Lite: {TX_LIMIT} transactions max — upgrade to Pro for unlimited + full analytics[/dim]",
    border_style="green"
))

# Category totals
cat_totals = defaultdict(float)
for t in transactions: cat_totals[t["category"]] += t["amount"]

console.print()
tbl = Table(title="Spend by Category", box=box.ROUNDED, border_style="green")
tbl.add_column("Category", width=20, style="cyan")
tbl.add_column(f"Total ({CURRENCY})", width=14, justify="right", style="red")
tbl.add_column("% of spend", width=12, justify="right", style="yellow")

for cat,total in sorted(cat_totals.items(),key=lambda x:-x[1]):
    pct = total/total_spend*100 if total_spend else 0
    tbl.add_row(cat, fmt(total), f"{pct:.1f}%")
console.print(tbl)

# Transaction list
console.print()
tx_tbl = Table(title="Transactions", box=box.SIMPLE, border_style="dim")
tx_tbl.add_column("#",           width=4,  style="dim")
tx_tbl.add_column("Description", width=28, style="white")
tx_tbl.add_column("Category",    width=18, style="cyan")
tx_tbl.add_column("Amount",      width=12, justify="right", style="red")
for i,t in enumerate(transactions,1):
    tx_tbl.add_row(str(i), t["description"][:26], t["category"], fmt(t["amount"]))
console.print(tx_tbl)

console.print()
console.print(Panel(
    f"[bold yellow]🔓 Want your full financial picture?[/bold yellow]\n\n"
    f"Plutus Pro handles [bold]unlimited transactions[/bold] from any bank CSV, tracks "
    f"[bold]tax-deductible expenses[/bold], shows [bold]monthly trends[/bold], "
    f"calculates your [bold]savings rate[/bold], and forecasts spending up to 12 months ahead.\n\n"
    f"[bold cyan]openclaw skills install plutus-pro[/bold cyan]\n"
    f"Get your key → [bold]ko-fi.com/s/83c662001e[/bold]",
    title="Upgrade to Plutus Pro",
    border_style="cyan"
))