git404hub

what is taxhacker fr?

vas3k/taxhacker — explained in plain English

Analysis updated 2026-06-26

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

tl;dr

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.

vibe map

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

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

TypeScriptDockerPostgreSQLOpenAIGeminiMistral

how it stacks up fr

vas3k/taxhackerdagrejs/dagreyeemachine/kalidokit
Stars5,6405,6415,638
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencepm founderdeveloperdeveloper

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

how do i run it?

Difficulty · easy time til it works · 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.

prompts (copy fr)

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?

Frequently asked questions

what is taxhacker fr?

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.

What language is taxhacker written in?

Mainly TypeScript. The stack also includes TypeScript, Docker, PostgreSQL.

What license does taxhacker use?

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

How hard is taxhacker to set up?

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

Who is taxhacker for?

Mainly pm founder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.