explaingit

vas3k/taxhacker

5,640TypeScriptAudience · pm founderComplexity · 2/5LicenseSetup · easy

TLDR

TaxHacker is a self-hosted app for freelancers that reads receipts and invoices using AI, automatically extracts the amounts and details, and organizes them into a searchable table you can export for your accountant.

Mindmap

mindmap
  root((repo))
    What it does
      Receipt scanning
      Invoice extraction
      Expense tracking
    AI integration
      OpenAI support
      Gemini support
      Local models
    Outputs
      CSV export
      Currency conversion
      Searchable table
    Setup
      Docker deploy
      PostgreSQL included
      Self-hosted data
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

Things people build with this

USE CASE 1

Upload photos of receipts and let AI automatically fill in the amount, date, vendor, and tax fields for your records

USE CASE 2

Export all transaction records as CSV with attached documents to hand off to your accountant at tax time

USE CASE 3

Track business expenses across 170 currencies with automatic conversion to your base currency using historical exchange rates

USE CASE 4

Keep all your financial documents private on your own server instead of uploading them to a third-party service

Tech stack

TypeScriptDockerPostgreSQLOpenAIGeminiMistral

Getting it running

Difficulty · easy Time to first run · 30min

Requires Docker and an AI provider API key (OpenAI, Gemini, or Mistral), or a locally running model if you prefer to keep data offline.

MIT license, use, modify, and distribute freely for any purpose including commercial use, as long as you keep the copyright notice.

In plain English

TaxHacker is a self-hosted accounting application aimed at freelancers, independent builders, and small businesses who want to automate the tedious parts of expense tracking. You take a photo of a receipt or upload an invoice PDF, and the app uses an AI model to read it and pull out the relevant details: the amount, date, vendor name, tax figures, and individual line items. All of that gets saved into a structured table you can filter and export. The AI part is flexible. You can connect it to OpenAI, Google Gemini, or Mistral, or point it at a locally running model if you prefer to keep everything on your own hardware. You can also write your own prompts to extract specific fields that matter to your situation, such as project codes, addresses, or custom categories that match how your business is organized. Currency handling is built in. The app detects the currency in any document and converts it to your chosen base currency using historical exchange rates from the actual transaction date. It supports over 170 currencies and 14 cryptocurrencies. The whole application runs in Docker, so deployment comes down to downloading a single compose file and running one command. It ships with a PostgreSQL database included in that setup. Because you host it yourself, your financial documents stay on your own infrastructure and never pass through a third-party service. Export works by generating CSV files with the transaction data and attached document files bundled together, which makes handing off records to an accountant or tax advisor straightforward. The project is open source under the MIT license and described as early in development, so some rough edges should be expected.

Copy-paste prompts

Prompt 1
I want to use TaxHacker to track my freelance expenses. How do I set it up with Docker and connect it to OpenAI? Show me the docker-compose.yml and the required environment variables.
Prompt 2
How do I write a custom extraction prompt in TaxHacker to pull out a specific field like project code or client name from my invoices?
Prompt 3
I have TaxHacker running but I want to use a local AI model instead of OpenAI to keep everything offline. How do I configure it to point to a locally running model?
Prompt 4
How do I export my TaxHacker expense records to CSV and what does the export format look like so I can prepare it for my accountant?
Prompt 5
TaxHacker is showing the wrong currency conversion for some of my transactions. How does the historical exchange rate lookup work and how can I correct entries?
Open on GitHub → Explain another repo

← vas3k on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.