---
title: TaxHacker
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, accounting, fiscal, freelance, tva, typescript, ia, ocr]
confidence: medium
contested: false
sources: [https://selfh.st/apps/?tag=Accounting, https://github.com/vas3k/TaxHacker, https://taxhacker.app/]
---

# TaxHacker 🧾

> Outil de gestion fiscale pour freelances et indépendants : import automatique des relevés bancaires, catégorisation IA, et calcul des impôts (notamment en Russie / pays de la CEI).

| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | https://taxhacker.app/ |
| **GitHub** | https://github.com/vas3k/TaxHacker |
| **License** | MIT |
| **Langage principal** | TypeScript (Next.js, React) + Python (parsing) |
| **Étoiles GitHub** | ⭐985 |
| **Dernière MAJ** | 2026-05-10 |
| **Catégorie** | [[cat-accounting]] |

## Description

TaxHacker est un **assistant fiscal self-hosted** conçu par Vasily Zubarev (vas3k) — un développeur russe bien connu dans la sphère open source ([vas3k.club](https://vas3k.club/), [parimatch.tech](https://parimatch.tech/)). L'objectif est de **simplifier la déclaration fiscale des freelances et indépendants** en agrégeant automatiquement les revenus et dépenses à partir de relevés bancaires, factures et tickets de caisse, puis en suggérant la catégorie fiscale optimale.

L'interface est construite en **Next.js + TypeScript** côté frontend et utilise un backend Node.js (Fastify) avec une base **SQLite** (par défaut) ou PostgreSQL. L'outil mise sur l'**automatisation par IA** : pour chaque transaction, un modèle de langage (LLM) suggère une catégorie, un type (revenu/dépense) et un tag ; l'utilisateur n'a plus qu'à valider. Les **factures PDF** peuvent être téléversées et indexées (OCR + extraction de données), ce qui permet de reconstituer un livre de recettes sans saisie manuelle.

L'**attention** : le projet est **initialement orienté régimes fiscaux russes et CEI** (УСН — système simplifié, патент, НПД — impôt sur le revenu professionnel) et les **modèles d'IA par défaut** sont entraînés pour ces régimes. Pour un usage en France (URSSAF, auto-entrepreneur, BNC/BNC, TVA), il faudra **personnaliser les catégories et prompts** — c'est faisable mais demande du temps. Le projet reste **très intéressant techniquement** et constitue une base solide pour quiconque veut construire son propre assistant fiscal local.

## Installation

### Via Docker (recommandé)

```yaml
# docker-compose.yml
services:
  app:
    image: ghcr.io/vas3k/taxhacker:latest
    container_name: taxhacker
    restart: unless-stopped
    ports:
      - "3030:3000"
    environment:
      - APP_URL=http://localhost:3030
      - SECRET_KEY=Générer...Key
      - DATABASE_URL=file:./data/taxhacker.db
      - OPENAI_API_KEY=sk-***  # ou Ollama local
      - AI_PROVIDER=openai      # ou "ollama" pour 100% local
      - AI_MODEL=gpt-4o-mini
    volumes:
      - taxhacker-data:/app/data    # SQLite + uploads
      - taxhacker-uploads:/app/uploads

  # Optionnel : LLM local pour la confidentialité
  # ollama:
  #   image: ollama/ollama:latest
  #   container_name: taxhacker-ollama
  #   restart: unless-stopped
  #   volumes:
  #     - ollama-data:/root/.ollama
  #   # Puis pull : docker exec -it taxhacker-ollama ollama pull llama3.1

volumes:
  taxhacker-data:
  taxhacker-uploads:
  # ollama-data:
```

### Installation manuelle (développeur)

1. Pré-requis : Node.js 20+, pnpm, Python 3.11+ (parsing PDF), SQLite 3.
2. `git clone https://github.com/vas3k/TaxHacker.git && cd TaxHacker`
3. `pnpm install` puis `cp .env.example .env` et éditer.
4. Lancer les migrations : `pnpm prisma migrate dev`.
5. `pnpm dev` (Next.js) puis ouvrir `http://localhost:3000`.
6. Pour le LLM : par défaut OpenAI (clé API), ou auto-héberger Ollama pour 100% local.

## Configuration

- **Compte** : à la première connexion, créer l'utilisateur admin (configuré via `.env` ou seed).
- **Catégories fiscales** : ajouter les catégories françaises (BNC, BIC, frais réels, TVA déductible, etc.) — c'est la première chose à faire pour adapter au régime local.
- **Prompts IA** : éditer les prompts de catégorisation (`settings/ai-prompts/`) pour les rendre pertinents au régime français (ex : « revenu freelance Madelin, charges sociales URSSAF »).
- **Import bancaire** : format CSV (OFX, QIF) — la plupart des banques françaises exportent en CSV via l'espace client.
- **OCR factures** : téléverser un PDF, TaxHacker extrait montant, TVA, date, fournisseur.
- **Tableau de bord** : synthèse des revenus/dépenses, estimation de l'impôt (à calibrer avec les barèmes locaux).
- **Export** : CSV / Excel pour transmission à l'expert-comptable ou à l'URSSAF.

## Alternatives

### Open source
- [[app-akaunting]] — comptabilité complète, pas de catégorisation IA mais écosystème modules riche.
- [[app-firefly-iii]] — gestion budget personnel, philosophie « budget vs enveloppe », très bon pour suivre ses finances.
- [[app-actual-budget]] — budget envelope-based, interface moderne, import OFX natif.
- **GnuCash** — comptabilité double-partie desktop, très complet, courbe d'apprentissage raide.
- **Skrooge** — KDE/Plasma, gestion budget personnel avec import OFX, IA absente.

### Propriétaires
- **Pennylane** — pépite française, catégorisation bancaire automatique, OCR factures, dashboard.
- **Indy** — auto-entrepreneur, sync bancaire, déclaration URSSAF pré-remplie.
- **Sage** / **EBP Compta** — historiques français, peu d'IA.
- **TurboTax** / **H&R Block** — référence US/Canada, non adapté à la France.
- **TaxAct** — Russie/CEI (concurrent direct de TaxHacker dans son marché d'origine).

## Sécurité

- **Données financières ultrasensibles** : héberger TaxHacker **uniquement derrière un reverse proxy HTTPS** (Traefik, Caddy) avec un domaine dédié — ne pas l'exposer sur un port direct.
- **LLM local privilégié** : si on utilise un LLM pour la catégorisation, l'auto-hébergement via Ollama évite l'envoi des transactions à OpenAI. À privilégier pour les montants et contreparties.
- **2FA** : activer si l'application l'expose (ou protéger par un reverse proxy Authelia/Authentik).
- **Sauvegardes** : `taxhacker-data` contient la base SQLite — sauvegarder régulièrement ; c'est un simple fichier à copier.
- **Chiffrement au repos** : si l'hôte est sur un VPS, chiffrer le disque (LUKS / ZFS encryption) — un snapshot LSC expose les données fiscales.
- **Logs** : TaxHacker loggue les appels API LLM — purger régulièrement et vérifier qu'aucune donnée client n'est loguée en clair.

## Ressources
- Site officiel : https://taxhacker.app/
- Dépôt GitHub : https://github.com/vas3k/TaxHacker
- Démo en ligne : https://demo.taxhacker.app/
- Documentation : https://docs.taxhacker.app/
- Article de l'auteur : https://vas3k.com/blog/taxhacker/
- selfh.st : https://selfh.st/apps/?tag=Accounting

## Pages Liées
- [[cat-accounting]] (catégorie parente)
- [[app-akaunting]] — comptabilité Laravel complète
- [[app-firefly-iii]] — budget personnel
- [[recettes-docker-compose]] — templates de déploiement
- [[self-hosting-llm]] — auto-héberger Ollama pour la confidentialité
- [[securisation-home-lab]] — bonnes pratiques
