""" app.py — Smart Budget Planner (Gradio) Hugging Face Space entry point. Run locally: pip install gradio python app.py """ import gradio as gr # ───────────────────────────────────────── # Python calculation engine # ───────────────────────────────────────── def calculate_budget( gross, fed_tax, fica, retire, health, rent, electric, internet, phone, groceries, dining, transport, subs, personal, emergency, invest, vacation, ): """ Pure-Python budget engine. Returns a dict of all derived metrics. """ gross = float(gross or 0) # ── Deductions (pre-tax) ── ded_total = float(fed_tax + fica + retire + health) net = gross - ded_total # ── Housing ── housing_total = float(rent + electric + internet + phone) # ── Living ── living_total = float(groceries + dining + transport + subs + personal) # ── Goals ── goals_total = float(emergency + invest + vacation) # ── Fixed vs variable ── fixed_total = float( fed_tax + fica + retire + health + # deductions always fixed rent + internet + phone + # fixed housing subs + # fixed living emergency + invest + vacation # goals always fixed ) var_total = float(electric + groceries + dining + transport + personal) total_exp = housing_total + living_total + goals_total leftover = net - housing_total - living_total - goals_total # ── Budget score 0–100 ── if net > 0: score = max(0, min(100, round( (leftover / net) * 60 + (goals_total / net) * 40 * 3 ))) else: score = 0 def pct(val, base): return round(val / base * 100) if base > 0 else 0 def fmt(val): return f"${abs(round(val)):,}" # ── Score label ── if score >= 70: score_label = "Healthy" score_color = "green" elif score >= 40: score_label = "Fair — room to improve" score_color = "orange" else: score_label = "Needs attention" score_color = "red" leftover_label = "Over budget!" if leftover < 0 else f"{pct(leftover, net)}% unallocated" # ── Suggestions ── suggestions = [] if pct(dining, net) > 8: suggestions.append(("⚠️", f"Dining out is {pct(dining, net)}% of net. Trimming to 6% would save {fmt(dining - net * 0.06)}/mo.")) else: suggestions.append(("✅", f"Dining spend is healthy at {pct(dining, net)}% of net income.")) if pct(retire, gross) < 10: suggestions.append(("⚠️", f"Retirement is {pct(retire, gross)}% of gross. Target 10–15% for long-term security.")) else: suggestions.append(("✅", f"Retirement contribution is {pct(retire, gross)}% of gross — solid.")) if pct(emergency, net) < 5: suggestions.append(("🔴", f"Emergency fund is only {pct(emergency, net)}% of net. Aim for at least 5% monthly.")) else: suggestions.append(("✅", f"Emergency savings rate is on track at {pct(emergency, net)}% of net.")) if leftover < 0: suggestions.append(("🔴", f"Over budget by {fmt(abs(leftover))}. Review variable expenses to find savings.")) elif pct(leftover, net) > 15: suggestions.append(("✅", f"{pct(leftover, net)}% unallocated ({fmt(leftover)}). Consider boosting investments or savings goals.")) if pct(fixed_total, net) > 72: suggestions.append(("⚠️", f"Fixed costs are {pct(fixed_total, net)}% of net — high. This reduces financial flexibility.")) suggestions_md = "\n".join(f"{icon} {text}" for icon, text in suggestions[:5]) return { # metric cards "net": fmt(net), "net_pct": f"{pct(net, gross)}% of gross", "total_exp": fmt(total_exp), "total_exp_sub":f"{pct(total_exp, net)}% of net · Fixed {pct(fixed_total, net)}% · Variable {pct(var_total, net)}%", "score": f"{score} / 100", "score_label": score_label, "leftover": ('' if leftover >= 0 else '-') + fmt(leftover), "leftover_sub": leftover_label, # chart data (raw numbers for Plotly) "chart_deductions": round(ded_total), "chart_housing": round(housing_total), "chart_living": round(living_total), "chart_goals": round(goals_total), "chart_leftover": round(max(0, leftover)), # expense % breakdown for the table "pct_rent": pct(rent, net), "pct_groceries": pct(groceries, net), "pct_dining": pct(dining, net), "pct_retire": pct(retire, gross), "pct_emergency": pct(emergency, net), # suggestions "suggestions": suggestions_md, # raw values for What-if echo "net_raw": round(net), "leftover_raw": round(leftover), "score_raw": score, } def run_budget(*args): """ Gradio callback — receives all slider/number inputs, returns formatted output strings for each Output component. """ r = calculate_budget(*args) metric_md = f""" ### 📊 Budget summary | Metric | Value | Detail | |--------|-------|--------| | Take-home (net) | **{r['net']}** | {r['net_pct']} | | Total expenses | **{r['total_exp']}** | {r['total_exp_sub']} | | Budget score | **{r['score']}** | {r['score_label']} | | Leftover | **{r['leftover']}** | {r['leftover_sub']} | """ suggestions_md = f"### 💡 Suggestions\n\n{r['suggestions']}" return metric_md, suggestions_md def run_whatif( gross, fed_tax, fica, retire, health, rent, electric, internet, phone, groceries, dining, transport, subs, personal, emergency, invest, vacation, wi_rent, wi_groceries, wi_dining, wi_transport, wi_dining_out, wi_electric, wi_personal, wi_subs, wi_emergency, wi_invest, wi_vacation, ): """ What-if callback — compares original vs adjusted values. """ orig = calculate_budget( gross, fed_tax, fica, retire, health, rent, electric, internet, phone, groceries, dining, transport, subs, personal, emergency, invest, vacation, ) # Build adjusted inputs by substituting what-if overrides adj = calculate_budget( gross, fed_tax, fica, retire, health, wi_rent, wi_electric, internet, phone, wi_groceries, wi_dining_out, wi_transport, wi_subs, wi_personal, wi_emergency, wi_invest, wi_vacation, ) left_delta = adj["leftover_raw"] - orig["leftover_raw"] score_delta = adj["score_raw"] - orig["score_raw"] sign = lambda v: ("+" if v >= 0 else "") + f"${abs(v):,}" impact_md = f""" ### ⚡ Ripple impact | | Original | Adjusted | Change | |--|---------|----------|--------| | Leftover | **{orig['leftover']}** | **{adj['leftover']}** | {sign(left_delta)} | | Budget score | **{orig['score']}** | **{adj['score']}** | {sign(score_delta).replace('$','')} pts | | Total expenses | **{orig['total_exp']}** | **{adj['total_exp']}** | — | {adj['suggestions']} """ return impact_md # ───────────────────────────────────────── # Gradio UI # ───────────────────────────────────────── THEME = gr.themes.Soft( primary_hue="green", secondary_hue="blue", neutral_hue="slate", font=[gr.themes.GoogleFont("DM Sans"), "ui-sans-serif", "system-ui"], font_mono=[gr.themes.GoogleFont("JetBrains Mono"), "monospace"], ) CSS = """ /* ── General ── */ .gradio-container { max-width: 1100px !important; margin: 0 auto; } h1.app-title { font-size: 28px; font-weight: 700; margin-bottom: 2px; } p.app-sub { color: #6b7280; font-size: 14px; margin-bottom: 1.5rem; } /* ── Section headers ── */ .section-label { font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.06em; color: #6b7280; margin-bottom: 6px; } /* ── Badge-style group labels ── */ .badge-fixed { color: #0C447C; background: #E6F1FB; padding: 2px 8px; border-radius: 12px; font-size: 11px; font-weight: 600; } .badge-variable { color: #633806; background: #FAEEDA; padding: 2px 8px; border-radius: 12px; font-size: 11px; font-weight: 600; } .badge-pretax { color: #72243E; background: #FBEAF0; padding: 2px 8px; border-radius: 12px; font-size: 11px; font-weight: 600; } .badge-goals { color: #3C3489; background: #EEEDFE; padding: 2px 8px; border-radius: 12px; font-size: 11px; font-weight: 600; } /* ── Output markdown ── */ .output-box { background: #f8fafc; border-radius: 12px; padding: 1rem 1.25rem; border: 1px solid #e2e8f0; } """ with gr.Blocks(theme=THEME, css=CSS, title="Smart Budget Planner") as demo: # ── Header ── gr.HTML("""

Smart Budget Planner

Track · Analyze · Plan — edit any field and click Calculate

""") with gr.Tabs(): # ══════════════════════════════════ # TAB 1 — OVERVIEW # ══════════════════════════════════ with gr.TabItem("📊 Overview"): gr.Markdown("### Income") gross = gr.Number(label="Monthly gross income ($)", value=6000, minimum=0, step=100) with gr.Row(): # ── Deductions ── with gr.Column(): gr.HTML('Pre-tax deductions') fed_tax = gr.Number(label="Federal tax ($)", value=780, minimum=0, step=10) fica = gr.Number(label="FICA / Social Security ($)", value=459, minimum=0, step=10) retire = gr.Number(label="401(k) contribution ($)", value=300, minimum=0, step=10) health = gr.Number(label="Health insurance ($)", value=220, minimum=0, step=10) # ── Housing ── with gr.Column(): gr.HTML('Housing & utilities — fixed') rent = gr.Number(label="Rent / Mortgage ($)", value=1400, minimum=0, step=50) electric = gr.Number(label="Electricity ($)", value=95, minimum=0, step=5) internet = gr.Number(label="Internet ($)", value=60, minimum=0, step=5) phone = gr.Number(label="Phone ($)", value=45, minimum=0, step=5) with gr.Row(): # ── Living ── with gr.Column(): gr.HTML('Living expenses — variable') groceries = gr.Number(label="Groceries ($)", value=350, minimum=0, step=10) dining = gr.Number(label="Dining out ($)", value=180, minimum=0, step=10) transport = gr.Number(label="Transportation ($)", value=120, minimum=0, step=10) subs = gr.Number(label="Subscriptions ($)", value=55, minimum=0, step=5) personal = gr.Number(label="Personal care ($)", value=70, minimum=0, step=5) # ── Goals ── with gr.Column(): gr.HTML('Goals & savings — planned') emergency = gr.Number(label="Emergency fund ($)", value=200, minimum=0, step=10) invest = gr.Number(label="Investments ($)", value=150, minimum=0, step=10) vacation = gr.Number(label="Vacation savings ($)", value=100, minimum=0, step=10) calc_btn = gr.Button("Calculate budget", variant="primary", size="lg") with gr.Row(): metric_out = gr.Markdown(elem_classes="output-box") suggestion_out = gr.Markdown(elem_classes="output-box") # All input components for convenience all_inputs = [ gross, fed_tax, fica, retire, health, rent, electric, internet, phone, groceries, dining, transport, subs, personal, emergency, invest, vacation, ] calc_btn.click( fn=run_budget, inputs=all_inputs, outputs=[metric_out, suggestion_out], ) # Also recalc on any change for a live feel for comp in all_inputs: comp.change( fn=run_budget, inputs=all_inputs, outputs=[metric_out, suggestion_out], ) # ══════════════════════════════════ # TAB 2 — WHAT-IF PLANNER # ══════════════════════════════════ with gr.TabItem("⚡ What-if planner"): gr.Markdown(""" > **Scenario mode** — your original budget (entered on the Overview tab) stays unchanged. > Adjust the sliders below to explore "what if?" scenarios and instantly see the ripple effect. """) with gr.Row(): with gr.Column(): gr.HTML('Housing adjustments') wi_rent = gr.Slider(label="Rent / Mortgage ($)", minimum=0, maximum=4000, value=1400, step=50) wi_electric = gr.Slider(label="Electricity ($)", minimum=0, maximum=500, value=95, step=5) with gr.Column(): gr.HTML('Living adjustments') wi_groceries = gr.Slider(label="Groceries ($)", minimum=0, maximum=1000, value=350, step=10) wi_dining_out = gr.Slider(label="Dining out ($)", minimum=0, maximum=800, value=180, step=10) wi_transport = gr.Slider(label="Transportation ($)", minimum=0, maximum=600, value=120, step=10) wi_subs = gr.Slider(label="Subscriptions ($)", minimum=0, maximum=300, value=55, step=5) wi_personal = gr.Slider(label="Personal care ($)", minimum=0, maximum=400, value=70, step=5) with gr.Row(): with gr.Column(): gr.HTML('Goals adjustments') wi_emergency = gr.Slider(label="Emergency fund ($)", minimum=0, maximum=1000, value=200, step=10) wi_invest = gr.Slider(label="Investments ($)", minimum=0, maximum=1000, value=150, step=10) wi_vacation = gr.Slider(label="Vacation savings ($)", minimum=0, maximum=500, value=100, step=10) with gr.Column(): impact_out = gr.Markdown(elem_classes="output-box") wi_inputs = [ gross, fed_tax, fica, retire, health, rent, electric, internet, phone, groceries, dining, transport, subs, personal, emergency, invest, vacation, wi_rent, wi_groceries, wi_dining_out, wi_transport, wi_dining_out, wi_electric, wi_personal, wi_subs, wi_emergency, wi_invest, wi_vacation, ] for sl in [wi_rent, wi_electric, wi_groceries, wi_dining_out, wi_transport, wi_subs, wi_personal, wi_emergency, wi_invest, wi_vacation]: sl.change(fn=run_whatif, inputs=wi_inputs, outputs=impact_out) # ══════════════════════════════════ # TAB 3 — ABOUT # ══════════════════════════════════ with gr.TabItem("ℹ️ About"): gr.Markdown(""" ## Smart Budget Planner A personal finance tool for tracking monthly income and expenses with built-in suggestions and a What-if scenario planner. ### How to use 1. **Overview tab** — Enter your gross income and edit any expense field. Hit *Calculate budget* or just change any value — results update automatically. 2. **What-if tab** — Keep your real budget on the Overview tab, then drag sliders here to simulate changes (cutting dining, boosting savings, etc.) and instantly see the ripple effect on your leftover and budget score. ### Budget score The 0–100 score is calculated from two components: - **Up to 60 points** based on leftover income as a share of net pay (positive leftover = good) - **Up to 40 points** based on your savings/goals rate (encourages prioritising future security) | Score | Rating | |-------|--------| | 70–100 | Healthy | | 40–69 | Fair | | 0–39 | Needs attention | ### Suggestions engine The suggestions panel checks: - Dining out as % of net (target: under 8%) - Retirement contributions as % of gross (target: 10–15%) - Emergency fund savings rate (target: at least 5% of net) - Overall leftover / over-budget status - Fixed cost load (warning if fixed > 72% of net) ### Tech stack Built with **Gradio** and pure Python. No external data is stored or transmitted. """) # ── Initial load ── demo.load( fn=run_budget, inputs=all_inputs, outputs=[metric_out, suggestion_out], ) # ───────────────────────────────────────── # Launch # ───────────────────────────────────────── if __name__ == "__main__": demo.launch()