ai-translate & ai-summarize : des documents confidentiels, traités 100 % en local

Je travaille dans un bureau où un .docx atterrit dans ma boîte mail en néerlandais, en anglais ou en français. Pour de très bonnes raisons, j'ai parfois besoin de traduire d'une langue vers une autre.

Quand ce n'est pas confidentiel du tout, le réflexe de tout le monde est d'ouvrir le navigateur, de coller dans un outil de traduction, et d'espérer que personne ne s'offusque qu'un contrat client vienne de transiter par les serveurs d'un tiers. Personne ne m'a jamais explicitement dit de ne pas le faire. C'est exactement le genre de chose pour laquelle vous ne devriez pas avoir besoin d'une permission.

Démo — ai-translate​

Traduction d'un contrat depuis n'importe quelle langue vers le français :

$ ai-translate contract.docx French

→ Converting 'contract.docx' with docling-convert...

## Note de livraison trimestrielle

*Périmètre, jalons et résiliation — diffusion interne uniquement*

### Article 1

À la suite de la revue trimestrielle tenue le 3 septembre, la présente note consacre le périmètre convenu, les jalons de livraison ainsi que les conditions de résiliation applicables à l'une ou l'autre des parties. Elle se substitue au projet diffusé en juillet. En cas de conflit entre une disposition des présentes et l'accord-cadre, c'est l'accord-cadre qui prévaut, sauf pour l'échéancier de paiement défini à l'article trois, qui est conçu pour le remplacer intégralement.

### Article 2

Le prestataire livrera la première tranche dans un délai de six semaines à compter de la signature, et chaque tranche subséquente à des intervalles n'excédant pas quatre semaines. Une tranche est réputée livrée dès qu'elle a été déployée dans l'environnement de staging et que les tests de réception consignés dans l'annexe B ont été validés. La livraison hors heures ouvrables ne réduit pas le délai de vérification, qui court pendant cinq jours ouvrables à compter de l'avis de livraison.

### Article 3

Les factures sont payables trente jours après réception. Le client peut retenir le paiement d'une tranche ayant échoué aux tests de réception, mais uniquement pour cette tranche et seulement jusqu'à la régularisation du défaut. Les intérêts de retard courent au taux légal. Aucune des parties ne peut compenser les sommes dues au titre des présentes avec celles dues au titre de tout autre accord sans le consentement écrit de l'autre partie.

### Article 4

Toute partie peut résilier le contrat sur préavis écrit de soixante jours. En cas de résiliation, le prestataire devra remettre tout avancement, y compris le code source, la configuration de build et la documentation, sous une forme permettant à un tiers compétent de poursuivre le travail. Le client devra payer les travaux achevés et acceptés jusqu'à la date de résiliation.

| Tranche   | Échéance   | Statut      |
| ------ | --- | --- |
| Première  | 6 semaines | Livrée      |
| Deuxième  | 10 semaines| En cours    |
▋

Et le même vers le néerlandais :

$ ai-translate contract.docx Dutch

→ Converting 'contract.docx' with docling-convert...

## Kwartaal Leveringsnota

*Reikwijdte, mijlpalen en beëindiging — uitsluitend voor intern gebruik*

### Artikel 1

Naar aanleiding van het kwartaaloverleg van 3 september houdt deze nota de overeengekomen reikwijdte, de leveringsmijlpalen en de voorwaarden vast onder welke elke partij kan opzeggen. Deze nota vervangt de in juli verspreide conceptversie. Indien een bepaling in deze nota strijdig is met de raamovereenkomst, heeft de raamovereenkomst voorrang, met uitzondering van de in afdeling drie genoemde betalingsregeling, die geheel ter vervanging daarvan is bedoeld.

### Artikel 2

De leverancier levert de eerste levering binnen zes weken na ondertekening, en elke daaropvolgende levering in intervallen van maximaal vier weken. Een levering wordt geacht geleverd te zijn wanneer deze is geïmplementeerd in de staging-omgeving en de acceptatietests in appendix B zijn geslaagd. Levering buiten werkuren verkort het acceptatievenster niet, dat vijf werkdagen duurt te rekenen vanaf de kennisgeving van levering.

### Artikel 3

Facturen zijn betaalbaar binnen dertig dagen na ontvangst. De opdrachtgever mag de betaling voor een levering die niet is geaccepteerd, inhouden, maar uitsluitend voor die specifieke levering en alleen totdat het gebrek is verholpen. Rentevergoeding bij late betaling loopt tegen het wettelijk rentepercentage. Geen van beide partijen mag vorderingen uit deze nota verrekenen met vorderingen uit enige andere overeenkomst zonder schriftelijke toestemming van de andere partij.

### Artikel 4

Elke partij kan opzeggen met een opzegtermijn van zestig dagen schriftelijk. Bij beëindiging draagt de leverancier alle werk in uitvoering, inclusief broncode, buildconfiguratie en documentatie, over in een vorm die door een kundige derde kan worden voortgezet. De opdrachtgever betaalt voor het tot de datum van beëindiging voltooide en geaccepteerde werk.

| Levering    | Te leveren | Status      |
| ------ | --- | --- |
| Eerste      | 6 weken  | Geleverd   |
| Tweede      | 10 weken | In uitvoering |
▋

C'est un contrat de prestation fictif, converti depuis .docx et traduit en français/néerlandais, avec chaque titre et chaque terme en gras intact — le genre de document que je ne collerais vraiment pas dans un traducteur en ligne.

Même document, pour que vous puissiez l'essayer vous-même avant d'adapter l'une ou l'autre fonction à vos propres fichiers :

Démo — ai-summarize​

Le même contrat, condensé en quatre points clés plutôt que traduit :

$ ai-summarize contract.docx 4

→ Converting 'contract.docx' with docling-convert...

- First increment delivery due within 6 weeks of signature; subsequent increments delivered every ≤4 weeks, requiring staging deployment and Appendix B test completion within a 5-working-day acceptance window.
- Invoices payable 30 days from receipt; payment withholding permitted only for failed increments until remedied, with late interest accruing at the statutory rate.
- Either party may terminate with 60 days written notice, mandating handover of all work-in-progress, source code, and documentation, plus immediate payment for completed and accepted work.
- Framework agreement prevails except for the payment schedule, which is entirely replaced; first increment is delivered, second increment is due at 10 weeks.
▋

Les délais de livraison, les conditions de paiement, la clause de résiliation et les parties du contrat-cadre qui sont remplacées — les quatre points qui comptent, sortis sans lire le document complet.

Réutiliser Docling pour l'extraction​

Les deux fonctions ci-dessous partagent une tâche avant même de parler à Ollama : transformer un document en texte brut. J'ai déjà construit cette brique dans mon article sur Docling — docling-convert file.docx produit file.md en local, avec accélération GPU si vous l'avez configuré ainsi. Plutôt que de dupliquer cette logique deux fois, elle vit dans un petit helper :

Pas besoin de copier quoi que ce soit pour l'instant : les fichiers .zsh montrés dans cet article sont là pour être lus, et L'installer à la fin les crée tous dans ~/.zsh/fns/ pour vous.

# Shared document-to-text extraction for ai-translate and ai-summarize.
# .pdf/.docx/.pptx/.xlsx/.html go through docling-convert (see /blog/docling)
# first; .md/.markdown/.txt files are read directly, no conversion needed.
#
# Leading underscore: loads after _ollama.zsh (still alphabetically before
# ai-summarize.zsh and ai-translate.zsh), so _ollama_query is always ready.

_ai_extract_text() {
  local file="$1"
  local ext="${file:e:l}"?

  case "$ext" in
    md|markdown|txt)
      cat "$file"
      ;;
    pdf|docx|pptx|xlsx|html|htm)
      if ! command -v docling-convert >/dev/null 2>&1; then?
        echo "_ai_extract_text: docling-convert not found — see /blog/docling to set it up" >&2
        return 1
      fi
      local dir filename base mdfile
      dir="${file:h}"?
      filename="${file:t}"?
      base="${filename%.*}"?
      mdfile="${dir}/${base}.md"?
      echo "→ Converting '$file' with docling-convert..." >&2
      ( cd "$dir" && docling-convert "$filename" >/dev/null 2>&1 ) || {?
        echo "_ai_extract_text: docling-convert failed on '$file'" >&2
        return 1
      }
      cat "$mdfile"?
      ;;
    *)
      echo "_ai_extract_text: unsupported extension .$ext (expected pdf/docx/pptx/xlsx/html/md/txt)" >&2
      return 1
      ;;
  esac
}

ai-translate​

# ai-translate <file> [language] — translate a document into the given
# language (default: French), entirely locally. Accepts .pdf/.docx/.pptx/
# .xlsx/.html (via docling-convert) or plain .md/.txt files directly.

AI_COMMANDS[translate]="ai-translate <file> [language]  — translate a document locally (default: French)"

ai-translate() {
  local file="$1"
  local lang="${2:-French}"?

  if [[ -z "$file" || ! -f "$file" ]]; then?
    echo "Usage: ai-translate <file> [target-language]" >&2
    return 1
  fi

  local text
  text=$(_ai_extract_text "$file") || return 1?

  local prompt="Translate the following document into $lang. Preserve the Markdown structure exactly — headings, lists, tables, emphasis. Output only the translated document, no commentary and no notes about the translation.?

$text"

  _ollama_query "$prompt"
}

On extrait, puis on demande au modèle de traduire vers la langue passée en second argument (le français par défaut — celle dont j'ai le plus souvent besoin), avec une instruction explicite de préserver la structure Markdown pour que les titres, listes et tableaux survivent à l'aller-retour au lieu de s'écrouler en un pavé de texte.

ai-summarize​

# ai-summarize <file> [points] — summarize a document in N bullet points
# (default: 5), entirely locally. Accepts .pdf/.docx/.pptx/.xlsx/.html (via
# docling-convert) or plain .md/.txt files directly.

AI_COMMANDS[summarize]="ai-summarize <file> [points]  — summarize a document locally (default: 5 points)"

ai-summarize() {
  local file="$1"
  local points="${2:-5}"?

  if [[ -z "$file" || ! -f "$file" ]]; then?
    echo "Usage: ai-summarize <file> [number-of-points]" >&2
    return 1
  fi

  local text
  text=$(_ai_extract_text "$file") || return 1?

  local prompt="Summarize the following document in exactly $points bullet points, written in the same language as the document. Prioritize decisions, numbers, deadlines and action items over generic description. Output only the bullet points, nothing else.?

$text"

  _ollama_query "$prompt"
}

Même étape d'extraction, prompt différent : un nombre fixe de points clés (5 par défaut), avec la consigne explicite de privilégier les décisions, les chiffres, les échéances et les actions à mener plutôt qu'une description générique — et de répondre dans la langue du document source, plutôt que de basculer silencieusement en anglais.

Enregistrées dans le menu ai​

Deux lignes — AI_COMMANDS[translate]=... et AI_COMMANDS[summarize]=... — et les deux sont accessibles via ai translate / ai summarize, ou directement via ai-translate / ai-summarize, aux côtés de toutes les autres fonctions de cette série.

Les deux fonctions appellent _ollama_query et s'enregistrent dans AI_COMMANDS, qui vivent dans la base partagée _ollama.zsh introduite dans ai-test. Si vous avez déjà suivi un article précédent de cette série, elle est déjà dans ~/.zsh/fns/ et sourcée par votre autoloader — rien de plus à faire. Vous commencez ici ? C'est l'un des fichiers créés dans L'installer ci-dessous.

À retenir​

L'installer​

Tout tourne sur votre machine : zsh, curl et jq (qui construit la requête envoyée à Ollama), et un serveur Ollama que vous pouvez joindre — voyez installing Ollama si vous n'en avez pas encore. Pour les fichiers .pdf, .docx, .pptx, .xlsx et .html, il vous faut aussi docling-convert, issu de mon article sur Docling.

1. Créez les fichiers. Chaque fonction de cette série vit dans son propre fichier dans ~/.zsh/fns/. La commande ci-dessous crée ce dossier et les quatre fichiers d'un coup — ou téléchargez le ZIP, ou créez chaque fichier à la main et collez son contenu. _ollama.zsh est la base que toute la série partage : si un article précédent vous l'a déjà donnée, la copie ici est le même fichier.

2. Chargez le dossier depuis ~/.zshrc. Déjà fait si vous avez suivi un article précédent de cette série. Sinon, ajoutez ces lignes à la fin de ~/.zshrc — elles sourcent chaque fichier .zsh du dossier, donc la prochaine fonction que vous ajoutez ne demandera aucune modification ici :

for fn_file in ~/.zsh/fns/*.zsh; do
  source "$fn_file"
done

3. Ouvrez un nouveau terminal (ou lancez exec zsh dans celui en cours), et vérifiez que le shell connaît les nouvelles fonctions :

type ai-translate ai-summarize

ai-translate is a shell function from …/ai-translate.zsh signifie que vous êtes prêt. ai-translate not found signifie que l'étape 2 manque.

Conclusion​

La vraie histoire de confidentialité ici n'est ni une politique ni une promesse — c'est une architecture. Un document entre, Docling le transforme en texte sans appel réseau, Ollama traite ce texte sans appel réseau, et le résultat atterrit dans mon terminal. Il n'y a aucune étape de cette chaîne où « faire confiance au fournisseur » est nécessaire, et c'est exactement ce qui la rend utilisable pour les documents que je n'aurais jamais risqués sur un outil cloud. Entre ça, ai-ci pour les pipelines, ai-standup pour le récap du matin et le reste de cette série, le modèle local que j'avais déjà en route pour d'autres raisons trouve sans cesse une chose de plus à faire, discrètement, en arrière-plan, sans rien me demander d'autre qu'un chemin de fichier.