132 lines
7.2 KiB
Markdown
132 lines
7.2 KiB
Markdown
---
|
|
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
|