← all repositories
vas3k/TaxHacker

Self-hosted receipt scanner where you write the LLM prompts

TaxHacker exists to stop freelancers from manually transcribing receipts by letting a local LLM extract structured data for tax season.

TaxHacker
Velocity · 7d
+1.7
★ / day
Trend
cooling
star history

What it does

TaxHacker is a Next.js application that ingests photos and PDFs of receipts, invoices, and bank statements, then uses an LLM to extract structured accounting data—dates, amounts, merchants, line items, taxes—into a PostgreSQL database. You can define custom fields and categories, split multi-item invoices into separate transactions, and filter or export the results to CSV. It also converts foreign currencies and fourteen cryptocurrencies to your base rate using historical exchange data from the transaction date.

The interesting bit

Most receipt scanners give you a black-box API and rigid fields; TaxHacker exposes the system prompts and lets you write per-field extraction rules, so you can teach the model to pull project codes, addresses, or whatever your accountant actually needs. It speaks to any OpenAI-compatible endpoint, including local stacks like Ollama or vLLM, which means your financial documents never have to leave your server.

Key highlights

  • Custom AI prompts for every field, category, and project, including the base system template
  • Local LLM support via OpenAI-compatible APIs (Ollama, LM Studio, vLLM, LocalAI)
  • Automatic currency conversion across 170+ fiat currencies and 14 cryptocurrencies using historical rates
  • Multi-project organization with full-text search, bulk operations, and CSV export
  • Docker-native self-hosting with PostgreSQL; no external SaaS required

Caveats

  • The project is explicitly in early development and carries a “use at your own risk” warning
  • Local LLM OCR quality depends entirely on the model you choose; the README notes results are “not guaranteed”

Verdict

Freelancers, indie hackers, and small-business developers who currently dump receipts into a shoebox will get the most value—especially if they already run a home server. If you need battle-tested, audit-grade accounting software or hate writing prompts, wait for a stable release or stick to your spreadsheet.

Frequently asked

What is vas3k/TaxHacker?
TaxHacker exists to stop freelancers from manually transcribing receipts by letting a local LLM extract structured data for tax season.
Is TaxHacker open source?
Yes — vas3k/TaxHacker is open source, released under the MIT license.
What language is TaxHacker written in?
vas3k/TaxHacker is primarily written in TypeScript.
How popular is TaxHacker?
vas3k/TaxHacker has 6.5k stars on GitHub and is currently cooling off.
Where can I find TaxHacker?
vas3k/TaxHacker is on GitHub at https://github.com/vas3k/TaxHacker.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.