financial-calculatorAdvanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest. Use when calculating investment growth, pricing strategies, loan values, discounts, or comparing financial scenarios across different rates and time periods. Includes both CLI and interactive web UI.
Install via ClawdBot CLI:
clawdbot install Tarigha/financial-calculatorComprehensive financial calculations including future value, present value, discount/markup pricing, compound interest, and comparative tables.
# Future Value
python3 scripts/calculate.py fv 10000 0.05 10 12
# PV=$10,000, Rate=5%, Years=10, Monthly compounding
# Present Value
python3 scripts/calculate.py pv 20000 0.05 10 12
# FV=$20,000, Rate=5%, Years=10, Monthly compounding
# Discount
python3 scripts/calculate.py discount 100 20
# Price=$100, Discount=20%
# Markup
python3 scripts/calculate.py markup 100 30
# Cost=$100, Markup=30%
# Future Value Table
python3 scripts/calculate.py fv_table 10000 0.03 0.05 0.07 --periods 1 5 10 20
# Principal=$10,000, Rates=3%,5%,7%, Periods=1,5,10,20 years
# Discount Table
python3 scripts/calculate.py discount_table 100 10 15 20 25 30
# Price=$100, Discounts=10%,15%,20%,25%,30%
Launch the interactive calculator:
./scripts/launch_ui.sh [port]
# Default port: 5050
# Opens at: http://localhost:5050
# Auto-creates venv and installs Flask if needed
Or manually:
cd skills/financial-calculator
python3 -m venv venv # First time only
venv/bin/pip install flask # First time only
venv/bin/python scripts/web_ui.py [port]
Features:
Calculate what an investment will be worth in the future with compound interest.
Use cases:
Inputs:
Calculate the current value of a future amount (discounted value).
Use cases:
Inputs:
Calculate final price after applying percentage discount.
Use cases:
Inputs:
Outputs:
Calculate selling price from cost and markup percentage.
Use cases:
Inputs:
Outputs:
Detailed breakdown of compound interest calculations.
Use cases:
Outputs:
Generate comparison table across multiple rates and time periods.
Use cases:
Features:
Compare multiple discount percentages for the same price.
Use cases:
Features:
Requires Python 3.7+ and Flask:
pip install flask
Or with venv:
python3 -m venv venv
source venv/bin/activate
pip install flask
Import the calculation module:
from calculate import (
future_value,
present_value,
discount_amount,
markup_price,
compound_interest,
generate_fv_table,
generate_discount_table
)
# Calculate FV
fv = future_value(
present_value=10000,
rate=0.05, # 5% as decimal
periods=10,
compound_frequency=12 # Monthly
)
# Generate table
table = generate_fv_table(
principal=10000,
rates=[0.03, 0.05, 0.07], # As decimals
periods=[1, 5, 10, 20]
)
See references/formulas.md for detailed mathematical formulas, examples, and use cases for all calculations.
Rate Format:
Compounding Frequencies:
Table Generation:
Best practices for meaningful comparisons:
Performance:
Generated Mar 1, 2026
Financial advisors use the Future Value Calculator and FV Table to project client investment growth across different asset classes and time horizons. They compare multiple interest rates and compounding frequencies to create personalized retirement plans and savings strategies, helping clients visualize long-term outcomes.
Retail managers apply the Discount Calculator and Discount Table to set sale prices and plan promotional campaigns. They analyze final prices and savings percentages for bulk discounts, optimizing profit margins while attracting customers during seasonal sales or clearance events.
Bank analysts utilize the Present Value Calculator to value loans and bonds by discounting future cash flows. They assess different discount rates and compounding periods to determine fair market prices, supporting risk assessment and investment decisions in lending portfolios.
Small business owners use the Markup Calculator to set selling prices based on cost and desired profit margins. They generate tables to compare multiple markup percentages, ensuring competitive pricing while maintaining profitability across product lines.
Educators in finance courses employ the Compound Interest Calculator and FV Table to teach students about interest accumulation and investment comparisons. They demonstrate real-time calculations with interactive tables, enhancing learning through practical scenario analysis.
Offer the Financial Calculator Pro as a cloud-based service with premium features like advanced table exports and API access. Charge monthly or annual subscriptions to businesses and individuals, generating recurring revenue from financial professionals and small enterprises.
Provide a free basic version with CLI and web UI access, then upsell to a paid tier with additional calculators, detailed analytics, and priority support. Monetize through in-app purchases or one-time licenses for advanced users in industries like consulting or real estate.
License the Python API to large corporations for embedding into internal financial systems, such as banking platforms or retail management software. Offer customization and support contracts, creating revenue from enterprise clients seeking tailored financial calculation modules.
š¬ Integration Tip
Integrate the Python API into existing financial dashboards by importing calculation functions; ensure rate inputs use decimals for consistency across CLI, web UI, and API calls.
Query Copilot Money personal finance data (accounts, transactions, net worth, holdings, asset allocation) and refresh bank connections. Use when the user asks about finances, account balances, recent transactions, net worth, investment allocation, or wants to sync/refresh bank data.
Stripe API integration with managed OAuth. Manage customers, subscriptions, invoices, products, prices, and payments. Use this skill when users want to process payments, manage billing, or handle subscriptions with Stripe. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
QuickBooks API integration with managed OAuth. Manage customers, invoices, payments, bills, and run financial reports. Use this skill when users want to interact with QuickBooks accounting data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Track expenses via natural language, get spending summaries, set budgets
Query and manage personal finances via the official Actual Budget Node.js API. Use for budget queries, transaction imports/exports, account management, categorization, rules, schedules, and bank sync with self-hosted Actual Budget instances.
Track business income and expenses in structured CSV format. Categorize transactions, monitor cash flow, generate P&L summaries, and spot spending trends.