DEV.co
AI Frameworks · vas3k

TaxHacker

TaxHacker is a self-hosted AI accounting app that extracts transaction data from receipts, invoices, and PDFs using LLMs (OpenAI, Gemini, Ollama, etc.). It automatically categorizes expenses, handles multi-currency conversion with historical rates, and exports structured data for tax reporting.

Source: GitHub — github.com/vas3k/TaxHacker
6.5k
GitHub stars
1.1k
Forks
TypeScript
Primary language
MIT
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
Repositoryvas3k/TaxHacker
Ownervas3k
Primary languageTypeScript
LicenseMIT — OSI-approved
Stars6.5k
Forks1.1k
Open issues29
Latest releasev0.8.2 (2026-07-07)
Last updated2026-07-07
Sourcehttps://github.com/vas3k/TaxHacker

What TaxHacker is

TypeScript-based web application with PostgreSQL backend, Docker deployment, and pluggable LLM integration via OpenAI-compatible APIs. Supports OCR via AI models, custom field extraction via user-written prompts, and historical forex/crypto conversion.

Quickstart

Get the TaxHacker source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/vas3k/TaxHacker.gitcd TaxHacker# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Freelancer/Solo Business Expense Tracking

Scan receipts in bulk, auto-extract line items and dates, auto-categorize by project, and generate tax-ready exports—eliminates manual spreadsheet entry.

Multi-Currency International Freelancing

Automatically detect and convert foreign currencies and crypto using transaction-date historical rates; useful for remote workers invoiced in multiple currencies.

Privacy-First Financial Data Management

Self-host on your own infrastructure with zero cloud vendor lock-in; documents never leave your control and all processing remains local (if using Ollama or similar).

Implementation considerations

  • Early-stage software (v0.8.2, created March 2025): expect breaking changes, missing features, and potential data-model updates; test thoroughly before production use.
  • LLM choice impacts privacy and accuracy: OpenAI/Gemini send data to external APIs; local Ollama keeps data private but may have lower OCR accuracy for handwritten/complex documents.
  • PostgreSQL 17+ required; self-hosting requires Docker knowledge and infrastructure management (backups, security, updates, monitoring).
  • Custom LLM prompts are powerful but require understanding your document types and business logic; poorly tuned prompts may produce incorrect categorization.
  • Document upload and storage scale: verify PostgreSQL and disk storage capacity for your volume; no mention of rate limiting or quotas.

When to avoid it — and what to weigh

  • Regulated Financial Institution — This is a personal accounting tool, not a compliant accounting system. Banks, hedge funds, and regulated entities should use certified accounting software.
  • Requires Audit Trail and Legal Compliance — The project is stated to be in early development. Tamper-proof records, SOC2 compliance, and formal audit support are not mentioned and should not be assumed.
  • Need Enterprise Multi-Tenant Support — TaxHacker is designed for individual/small-team self-hosting, not multi-tenant SaaS with per-user access control and billing integration.
  • Require Professional Accounting Firm Integration — No mention of API for accountant dashboards, real-time sync, or integration with accounting firms' standard workflows.

License & commercial use

MIT License (permissive open-source). Allows commercial use, modification, distribution, and private use with minimal restrictions; must include license and copyright notice.

MIT is a permissive OSI-approved license and does permit commercial use. However, no warranty is provided by the original author. Users must audit the code (or hire an auditor) to verify its suitability for their business risk tolerance, tax jurisdiction requirements, and data handling standards. Early-stage maturity means production use carries higher operational risk; consider whether your business can tolerate potential bugs or data loss.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationAdequate
License clarityClear
Deployment complexityLow
DEV.co fitGood
Assessment confidenceHigh
Security considerations

No security audit or vulnerability disclosure policy is mentioned. Data is stored in user-controlled infrastructure when self-hosted (good for privacy, user responsible for DB/storage hardening). LLM API keys are user-provided; ensure secure storage and rotation. Documents are uploaded and processed; consider input validation and malware scanning if handling untrusted PDFs. Early-stage software: cryptography, CORS, CSRF, and access control should be reviewed before handling sensitive financial data. No mention of encryption at rest or in transit (TLS enforced by user).

Alternatives to consider

Wave Accounting (cloud SaaS)

Cloud-hosted, AICPA-compliant, includes invoicing and payroll; gives up self-hosting privacy but offers vendor support and audit trail.

Zoho Books (cloud SaaS)

Enterprise-grade multi-currency support, tax reporting templates, mobile app; suitable for small business teams; no self-hosting option.

Akaunting (open-source, self-hosted)

Self-hosted invoice and accounting system; more mature than TaxHacker; no AI receipt scanning, but community-backed and more established for baseline accounting.

Software development agency

Build on TaxHacker with DEV.co software developers

Deploy TaxHacker on your own infrastructure in minutes. Self-hosted, MIT-licensed, and fully customizable—take control of your financial data today.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

Related on DEV.co

Explore the category and the services that help you build with it.

TaxHacker FAQ

Can I use TaxHacker in a regulated jurisdiction without legal review?
No. Tax compliance varies by country, jurisdiction, and business type. Consult a tax professional or accountant in your jurisdiction before relying on TaxHacker as your primary accounting system.
How do I ensure my financial data stays private?
Self-host on your own server and use a local LLM (e.g., Ollama). If you use OpenAI/Gemini APIs, your documents and extractions are sent to their servers; review their privacy policies.
What happens if the original developer stops maintaining the project?
The code is open-source under MIT; anyone can fork and maintain it. However, security patches, bug fixes, and new features would depend on community activity. Assess this risk before production use.
Can I export my data to another accounting system?
Yes, data can be exported as CSV. Importing into other systems (QuickBooks, Xero, etc.) requires manual mapping or custom import scripting; no native connectors are mentioned.

Software developers & web developers for hire

Need help beyond evaluating TaxHacker? DEV.co is a software development agency offering software development services and web development for teams of every size. Our software developers and web developers build custom software, web applications, APIs, and ai frameworks integrations — and maintain them long-term.

Ready to Automate Your Expense Tracking?

Deploy TaxHacker on your own infrastructure in minutes. Self-hosted, MIT-licensed, and fully customizable—take control of your financial data today.