whatisgithub

What is gigledger?

cyber-dioxide/gigledger — explained in plain English

Analysis updated 2026-06-24

17HTMLAudience · pm founderComplexity · 2/5Setup · moderate

In one sentence

A self-hosted finance dashboard for freelancers that shows how much of your bank balance is safe to spend after taxes, tracks invoices and projects, and calculates how many months your cash covers your expenses.

Mindmap

mindmap
  root((gigledger))
    What it does
      Safe to Spend figure
      Tax obligation tracking
      Cash runway calculator
    Features
      Invoice management
      Project hour logging
      Client records
      PDF and CSV export
    Dashboard views
      Income and expenses
      Savings goals
      Recurring costs
    Tech stack
      Python
      Flask
      Local database
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

See exactly how much of your freelance balance you can safely spend after your quarterly tax reserve is subtracted.

USE CASE 2

Create invoices that automatically split payments into a spendable amount and a tax reserve when marked paid.

USE CASE 3

Track hours against client projects at hourly or fixed rates and see total invoiced versus outstanding per client.

USE CASE 4

Calculate how many months your current balance covers your expenses, color-coded green, yellow, or red.

What is it built with?

PythonFlaskHTMLCSSSQLite

How does it compare?

cyber-dioxide/gigledgerakash190104/kolkata-bus-routecvlab-kaist/worldkv
Stars171717
LanguageHTMLHTMLHTML
Setup difficultymoderateeasyhard
Complexity2/52/55/5
Audiencepm founderdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Runs on Python and Flask with a local database, ships with a demo account pre-loaded with six months of realistic data to explore before entering real numbers.

So what is it?

GigLedger is a finance dashboard you run on your own computer or server, built specifically for freelancers, contractors, and gig workers. The core idea is that typical personal finance apps don't account for the tax complexity of self-employment, while full accounting software is more than most solo workers need. GigLedger sits in the middle, giving you clear answers to three questions freelancers care about most: how much of your balance is actually safe to spend after setting aside taxes, what you owe this quarter, and how many months your current balance can cover your expenses. The dashboard pulls together income, expenses, invoices, client records, project tracking, savings goals, and recurring costs into one screen. A Safe to Spend figure subtracts your running tax obligation from your bank balance so you don't accidentally spend money that belongs to the government. A runway calculator divides your balance by your average monthly expenses over the last three months and color-codes the result: green for six or more months, yellow for three to six, red for under three. Invoicing is tightly connected to the financial picture. When you mark an invoice as paid, GigLedger automatically creates two transactions: one for the income and one that sets aside the tax portion as a reserve. Your tax obligation updates in real time without manual entries. You can also generate PDF invoices and export filtered transaction reports to CSV or PDF. Project and client management are included. You can log hours against projects, set hourly or fixed rates, and track deadlines. Client records store contact details and show totals for invoiced, paid, and outstanding amounts across all linked invoices. The app runs on Python and Flask, stores data in a local database, and supports multiple currencies and five color themes including a dark mode. It ships with a demo account pre-loaded with six months of realistic data so you can explore how everything works before entering your own numbers.

Copy-paste prompts

Prompt 1
I just started freelancing. Set up GigLedger, configure my tax rate, and walk me through entering my first invoice so the tax reserve calculates automatically.
Prompt 2
I want to see my GigLedger cash runway. Explain how it calculates months of runway from my current balance and the last three months of expenses.
Prompt 3
Generate a PDF invoice in GigLedger for a client, mark it paid, and show me how the automatic tax reserve transaction is created.
Prompt 4
I'm a freelancer in a country with a different currency. Walk me through changing GigLedger's currency setting and entering expenses in that currency.

Frequently asked questions

What is gigledger?

A self-hosted finance dashboard for freelancers that shows how much of your bank balance is safe to spend after taxes, tracks invoices and projects, and calculates how many months your cash covers your expenses.

What language is gigledger written in?

Mainly HTML. The stack also includes Python, Flask, HTML.

How hard is gigledger to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gigledger for?

Mainly pm founder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.