About

Imported from terminalskills/skills (skills/taxhacker/SKILL.md). Install upstream with npx skills add terminalskills/skills --skill taxhacker. Copyright stays with the author (MIT).

TaxHacker

Name: taxhacker
Author: terminalskills

Overview

Self-hosted AI accountant for freelancers, indie hackers, and small businesses. Upload receipts, invoices, or bank statements — the LLM extracts, categorizes, and stores everything in a structured database. Supports multi-currency with historical exchange rates and exports accountant-ready CSV reports.

Source: vas3k/TaxHacker (3.9k+ stars)

Instructions

1. Deploy with Docker

curl -O https://raw.githubusercontent.com/vas3k/TaxHacker/main/docker-compose.yml
docker compose up -d

The stack includes TaxHacker app, PostgreSQL, and Redis for background job processing. Access the UI at http://localhost:8000.

2. Configure AI provider

# In .env
AI_PROVIDER=openai              # openai, google, mistral
AI_MODEL=gpt-4o
OPENAI_API_KEY=sk-...
SECRET_KEY=your-random-secret-key

Provider	Models	Best For
OpenAI	GPT-4o, GPT-4o-mini	Best accuracy for complex invoices
Google Gemini	Gemini Pro, Flash	Good cost/quality balance
Mistral	Mistral Large, Small	EU data residency

3. Upload documents

Drop photos of receipts, invoice PDFs, or bank statement CSVs into the web UI. The AI extraction pipeline:

OCR for images, text extraction for PDFs
LLM identifies vendor, date, amount, currency, line items, tax
Auto-categorizes into configurable categories
Stores structured data in PostgreSQL

4. Import bank statements

Go to Settings → Import, upload your bank's CSV export, map columns (date, description, amount, currency), and AI auto-categorizes each transaction.

5. Generate tax reports

Filter transactions by date range, category, project, or currency. Export to CSV for your accountant.

Examples

Example 1: Freelancer quarterly tax prep

A freelancer in Berlin uploads 3 months of receipts and a Sparkasse bank statement CSV:

Upload: 47 receipt photos + bank_statement_Q1_2024.csv
→ AI processes all documents in background (~2 minutes)
→ 142 transactions categorized:
  - Software & Subscriptions: €1,847.00 (23 transactions)
  - Travel & Transport: €2,341.50 (18 transactions)
  - Office & Supplies: €456.00 (6 transactions)
  - Professional Services: €3,200.00 (4 transactions)
→ Export → CSV filtered by Q1 2024
→ Send to accountant for Umsatzsteuer filing

Example 2: Multi-currency invoice processing

An indie hacker invoicing clients in USD, EUR, and GBP:

Invoice: €1,250.00 from French client (2024-03-15)
→ Converted: $1,362.50 @ 1.0900 EUR/USD (historical rate)

Invoice: £800.00 from UK client (2024-03-20)
→ Converted: $1,016.00 @ 1.2700 GBP/USD (historical rate)

Bank deposit: $2,378.50 matched to both invoices
→ Category: Income — Client Revenue
→ Project: Auto-assigned based on invoice metadata

TaxHacker supports 170+ currencies and 14 cryptocurrencies with historical exchange rates.

Example 3: Custom AI extraction fields

Configure a "Tax Deductible" field with a custom AI prompt:

Custom prompt: "Analyze this expense. Is it deductible for a freelance
software developer in Germany? Answer: Yes (100%), Partial (50%), or No.
Consider: office supplies, software, hardware, professional development
are fully deductible. Meals are 70% deductible."

Receipt: Hetzner Cloud — €23.40/month server hosting
→ Tax Deductible: Yes (100%)
→ Category: Software & Subscriptions

Receipt: Restaurant dinner with client — €87.50
→ Tax Deductible: Partial (70%)
→ Category: Food & Entertainment

Guidelines

Batch upload — Drop multiple receipts at once; they queue and process in background
Custom prompts per field dramatically improve accuracy for your specific documents and tax jurisdiction
Quarterly exports — Set a calendar reminder to export each quarter for your accountant
Backup regularly — docker compose exec db pg_dump taxhacker > backup.sql
Production deployment — Use Hetzner VPS (CX22, ~$5/month) with Caddy/nginx for HTTPS
Requires an LLM API key (OpenAI, Google, or Mistral) — no built-in local model yet
OCR accuracy depends on receipt quality — crumpled or faded receipts may need manual correction
Not a replacement for double-entry bookkeeping software — designed for freelancer/indie hacker workflows

References

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/terminalskills-skills-taxhacker/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

terminalskills-skills-taxhacker.ocm.jsonjson

{
  "ocm": "1",
  "id": "terminalskills-skills-taxhacker",
  "kind": "skill",
  "name": "taxhacker",
  "description": "Self-hosted AI accounting tool that analyzes receipts, invoices, and bank transactions using LLMs. Use when: automating personal/business bookkeeping, categorizing expenses with AI, preparing tax documents, building self-hosted financial tools.",
  "publisher": "terminalskills",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "finance"
    ],
    "tags": [
      "skill-md",
      "accounting",
      "tax",
      "receipts",
      "self-hosted",
      "bookkeeping",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Self-hosted AI accounting tool that analyzes receipts, invoices, and bank transactions using LLMs. Use when: automating personal/business bookkeeping, categorizing expenses with AI, preparing tax documents, building self-hosted financial tools."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/terminalskills/skills",
      "path": "skills/taxhacker/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/terminalskills/skills/blob/HEAD/skills/taxhacker/SKILL.md",
      "key": "terminalskills/skills/skills/taxhacker/SKILL.md"
    },
    "compatibility": "Python 3.10+ or Docker",
    "license": "MIT"
  },
  "instructions": "# TaxHacker\n\n## Overview\n\nSelf-hosted AI accountant for freelancers, indie hackers, and small businesses. Upload receipts, invoices, or bank statements — the LLM extracts, categorizes, and stores everything in a structured database. Supports multi-currency with historical exchange rates and exports accountant-ready CSV reports.\n\n> Source: [vas3k/TaxHacker](https://github.com/vas3k/TaxHacker) (3.9k+ stars)\n\n## Instructions\n\n### 1. Deploy with Docker\n\n```bash\ncurl -O https://raw.githubusercontent.com/vas3k/TaxHacker/main/docker-compose.yml\ndocker compose up -d\n```\n\nThe stack includes TaxHacker a",
  "cost": {
    "context_tokens": 1125
  }
}

Fetch it by URL: GET /api/v1/registry/terminalskills-skills-taxhacker/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.