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, 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é)

# 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)

Pré-requis : Node.js 20+, pnpm, Python 3.11+ (parsing PDF), SQLite 3.
git clone https://github.com/vas3k/TaxHacker.git && cd TaxHacker
pnpm install puis cp .env.example .env et éditer.
Lancer les migrations : pnpm prisma migrate dev.
pnpm dev (Next.js) puis ouvrir http://localhost:3000.
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

7.2 KiB Raw Permalink Blame History