✓ Verified ✍️ Content Creation ✓ Enhanced Data

Freelance Toolkit Fr

Boîte à outils pour freelances/indépendants en France : factures, time tracking, clients, dashboard.

Rating: 3.8 (260 reviews)
Downloads: 5,914 downloads
Version: 1.0.0

Overview

Boîte à outils pour freelances/indépendants en France : factures, time tracking, clients, dashboard.

Complete Documentation

View Source →

Freelance Toolkit

Boîte à outils pour freelances/indépendants en France : factures, time tracking, clients, dashboard.

Scripts

Tous dans scripts/. Python 3 stdlib uniquement. Données dans ~/.freelance/.

config.py — Configuration prestataire

bash

python3 config.py set --name "Hugo Dupont" --address "42 rue de la Paix, 75002 Paris" \
  --siret "98765432100010" --email "[email protected]" --phone "0600000000" \
  --iban "FR76 1234 5678 9012 3456 7890 123" --rate 80 --micro
python3 config.py show [--json]

Stockage : ~/.freelance/config.json

clients.py — Gestion clients

bash

python3 clients.py add --name "Acme" --email "[email protected]" --phone "0612345678" \
  --address "10 rue Example, 75001 Paris" --siret "12345678900010" --rate 80 --notes "Client fidèle"
python3 clients.py list [--json]
python3 clients.py show "Acme" [--json]
python3 clients.py edit "Acme" --rate 90 --notes "Nouveau taux"
python3 clients.py remove "Acme"

Stockage : ~/.freelance/clients.json

timetrack.py — Suivi du temps

bash

python3 timetrack.py start "Site web Acme" [--client "Acme"]
python3 timetrack.py stop
python3 timetrack.py status [--json]
python3 timetrack.py log [--from 2026-01-01] [--to 2026-01-31] [--project "Site web"] [--json]
python3 timetrack.py report [--month 2026-01] [--json]

Stockage : ~/.freelance/timetrack.json

invoice.py — Génération de factures HTML

bash

python3 invoice.py generate --client "Acme" --items "Dev site web:5:400" "Design logo:1:200" \
  [--number 2026-001] [--date 2026-02-15] [--due-days 30] [--no-open]
python3 invoice.py list [--json]
python3 invoice.py show 2026-001
python3 invoice.py paid 2026-001

Génère un HTML professionnel dans ~/.freelance/invoices/
Auto-numérotation YYYY-NNN si --number omis
Ouvre dans le navigateur par défaut (sauf --no-open)
Pré-remplit les infos client depuis clients.json si trouvé
Mentions légales françaises incluses (micro-entreprise par défaut)
paid marque une facture comme payée (suivi dans dashboard)
Montants au format français (2 900,00 €)
Initiales du prestataire comme logo sur la facture

dashboard.py — Tableau de bord revenus

bash

python3 dashboard.py summary [--year 2026] [--json]
python3 dashboard.py monthly [--year 2026] [--json]

Agrège factures + time tracking
CA total, par mois, par client
Heures travaillées, jours ouvrés (heures/7), taux horaire effectif
Factures payées vs impayées
Taux effectif calculé sur les mois avec CA uniquement

Configuration

Fichier optionnel ~/.freelance/config.json :

json

{
  "provider": {
    "name": "Hugo Dupont",
    "address": "42 rue de la Paix, 75002 Paris",
    "siret": "98765432100010",
    "email": "[email protected]",
    "phone": "0600000000"
  },
  "default_rate": 80,
  "tva_rate": 0,
  "micro_entreprise": true,
  "payment_delay_days": 30,
  "payment_method": "Virement bancaire",
  "iban": "FR76 1234 5678 9012 3456 7890 123"
}

Si micro_entreprise: true → TVA = 0%, mention art. 293B du CGI. Si tva_rate > 0 → TVA calculée sur chaque facture.

Données

Tout dans ~/.freelance/ :

text

~/.freelance/
├── config.json          — Configuration prestataire
├── clients.json         — Base clients
├── timetrack.json       — Entrées de temps
└── invoices/
    ├── 2026-001.html    — Factures HTML
    ├── 2026-001.json    — Métadonnées facture
    └── ...

Notes

Montants en euros (€), output en français
--json disponible sur toutes les commandes pour usage machine
Les factures HTML sont optimisées pour impression / export PDF via navigateur
Voir references/french-law.md pour le détail des obligations légales

Installation

Terminal bash


openclaw install freelance-toolkit-fr

Copied!

💻Code Examples

### config.py — Configuration prestataire

-configpy--configuration-prestataire.sh

python3 config.py set --name "Hugo Dupont" --address "42 rue de la Paix, 75002 Paris" \
  --siret "98765432100010" --email "[email protected]" --phone "0600000000" \
  --iban "FR76 1234 5678 9012 3456 7890 123" --rate 80 --micro
python3 config.py show [--json]

### clients.py — Gestion clients

-clientspy--gestion-clients.sh

python3 clients.py add --name "Acme" --email "[email protected]" --phone "0612345678" \
  --address "10 rue Example, 75001 Paris" --siret "12345678900010" --rate 80 --notes "Client fidèle"
python3 clients.py list [--json]
python3 clients.py show "Acme" [--json]
python3 clients.py edit "Acme" --rate 90 --notes "Nouveau taux"
python3 clients.py remove "Acme"

### timetrack.py — Suivi du temps

-timetrackpy--suivi-du-temps.sh

python3 timetrack.py start "Site web Acme" [--client "Acme"]
python3 timetrack.py stop
python3 timetrack.py status [--json]
python3 timetrack.py log [--from 2026-01-01] [--to 2026-01-31] [--project "Site web"] [--json]
python3 timetrack.py report [--month 2026-01] [--json]

### invoice.py — Génération de factures HTML

-invoicepy--gnration-de-factures-html.sh

python3 invoice.py generate --client "Acme" --items "Dev site web:5:400" "Design logo:1:200" \
  [--number 2026-001] [--date 2026-02-15] [--due-days 30] [--no-open]
python3 invoice.py list [--json]
python3 invoice.py show 2026-001
python3 invoice.py paid 2026-001

### dashboard.py — Tableau de bord revenus

-dashboardpy--tableau-de-bord-revenus.sh

python3 dashboard.py summary [--year 2026] [--json]
python3 dashboard.py monthly [--year 2026] [--json]

Fichier optionnel `~/.freelance/config.json` :

fichier-optionnel-freelanceconfigjson-.json

{
  "provider": {
    "name": "Hugo Dupont",
    "address": "42 rue de la Paix, 75002 Paris",
    "siret": "98765432100010",
    "email": "[email protected]",
    "phone": "0600000000"
  },
  "default_rate": 80,
  "tva_rate": 0,
  "micro_entreprise": true,
  "payment_delay_days": 30,
  "payment_method": "Virement bancaire",
  "iban": "FR76 1234 5678 9012 3456 7890 123"
}

Tout dans `~/.freelance/` :

tout-dans-freelance-.txt

~/.freelance/
├── config.json          — Configuration prestataire
├── clients.json         — Base clients
├── timetrack.json       — Entrées de temps
└── invoices/
    ├── 2026-001.html    — Factures HTML
    ├── 2026-001.json    — Métadonnées facture
    └── ...