LanguageTool en local : VS Code + Docker (sans cloud)

LanguageTool est un correcteur grammatical open source qui détecte les fautes d’orthographe, de grammaire et de style dans plus de 20 langues. Contrairement aux correcteurs cloud (Grammarly, ProWritingAid), vous pouvez l’installer localement avec Docker et l’utiliser dans VS Code, votre navigateur ou via API sans envoyer vos textes à un tiers. Idéal pour la confidentialité des documents techniques, rapports ou documentation produit.

Ce guide vous permet d’installer LanguageTool en local (version 6.7, sortie octobre 2025) et de le configurer dans VS Code en 15 minutes. Prérequis : Docker installé + VS Code.

Ce que vous allez apprendre

• Installer LanguageTool 6.7 en local avec Docker Compose
• Configurer l’extension VS Code pour corriger en temps réel
• Utiliser l’API REST pour intégrer dans vos outils
• Comparer gratuit vs Premium (4,99€/mois pour reformulation IA)

Pourquoi LanguageTool en local ?

Vous vous demandez peut-être : pourquoi installer LanguageTool en local alors que les extensions navigateur cloud sont si simples ? La réponse dépend de vos besoins en confidentialité, coût et autonomie.

Avec une solution cloud (Grammarly, ProWritingAid…), chaque texte que vous corrigez est envoyé sur les serveurs de l’entreprise. Pour des emails personnels, ce n’est pas un problème. Mais pour de la documentation technique confidentielle, des rapports d’audit ou des contrats clients, c’est une fuite de données potentielle.

L’installation locale résout ce problème : vos textes ne quittent jamais votre machine. Vous gardez le contrôle total, sans limite de caractères, et gratuitement.

Les avantages du déploiement local

Critère	LanguageTool local	Cloud (Grammarly, etc.)
Confidentialité	✅ Vos textes restent sur votre machine	❌ Textes envoyés au cloud
Coût	✅ Gratuit (version open source)	⚠️ 12-30€/mois pour fonctions avancées
Limite d’usage	✅ Illimité	❌ Quotas de caractères
Langues	✅ 20+ langues (français, anglais, allemand…)	✅ Multilingue
Complexité	⚠️ Installation Docker requise	✅ Extension navigateur immédiate

Glissez pour voir

Détails des avantages :

• Confidentialité : avec LanguageTool local, vos textes ne sont jamais transmis sur internet. Le serveur tourne sur votre machine (localhost). Idéal pour les environnements réglementés (santé, finance, défense).

• Coût : la version open source de LanguageTool est 100% gratuite. Les solutions cloud (Grammarly Premium, ProWritingAid) coûtent entre 12 et 30€/mois pour débloquer la détection avancée.

• Limite d’usage : pas de quota. Vous pouvez corriger un rapport de 100 000 mots sans abonnement. Les versions cloud gratuites limitent souvent à 400-500 caractères par vérification.

• Complexité : le seul inconvénient : vous devez installer Docker et lancer un conteneur. Mais une fois configuré (15 minutes), c’est aussi simple qu’une extension navigateur.

Cas d'usage idéaux

Utilisez LanguageTool local si :

• Vous rédigez des documents confidentiels (rapports techniques, contrats)
• Vous avez besoin de corriger massivement (scripts, documentation)
• Vous voulez éviter les abonnements cloud
• Vous travaillez dans un environnement sans accès internet

Ce que LanguageTool détecte

1. Erreurs grammaticales : accords, conjugaisons, structures de phrases incorrectes

   Exemple : “Les enfant jouent” → Correction : “Les enfants jouent”

2. Fautes d’orthographe : fautes de frappe, mots mal orthographiés

   Exemple : “Je vais au écolee” → Correction : “Je vais à l’école”

3. Erreurs contextuelles : mots corrects mais mal employés

   Exemple : “Leurs travaille est terminé” → Correction : “Leur travail est terminé”

4. Anglicismes et expressions inappropriées

   Exemple : “Je suis confus” → Suggestion : “Je suis désolé” (si contexte d’excuse)

5. Améliorations stylistiques : phrases trop longues, répétitions, formulations passives

   Exemple : “Le rapport a été rédigé par moi” → “J’ai rédigé le rapport”

Installation avec Docker Compose

Prérequis

• Docker : installer Docker
• Docker Compose : inclus avec Docker Desktop, ou installer séparément
• 2 Go de RAM minimum pour la JVM

Attention

Si Docker n’est pas installé, la commande docker compose échouera. Installez d’abord Docker avant de continuer.

Créer le fichier docker-compose.yml

Créez un dossier languagetool et ajoutez-y ce fichier docker-compose.yml :

services:
  languagetool:
    image: erikvl87/languagetool:6.7
    container_name: LanguageTool
    restart: always
    ports:
      - 8010:8010
    environment:
      - Java_Xms=512m  # Heap minimum Java
      - Java_Xmx=1g    # Heap maximum Java

Rappel express

L’image erikvl87/languagetool:6.7 contient LanguageTool version 6.7 (octobre 2025). Le port 8010 expose l’API REST en local.

Lancer le serveur

1. Placer vous dans le dossier contenant docker-compose.yml

2. Démarrer le conteneur :

   docker compose up -d

   L’option -d lance le conteneur en arrière-plan.

3. Vérifier que le conteneur est démarré :

   docker ps --filter "name=LanguageTool"

   Résultat attendu :

   NAMES          STATUS                    PORTS
   LanguageTool   Up 1 minute (healthy)     0.0.0.0:8010->8010/tcp

Tester l’API REST

Pour vérifier que LanguageTool fonctionne, envoyez une requête de test :

curl -X POST \
  --data "text=Je vais au écolee demain." \
  --data "language=fr" \
  http://localhost:8010/v2/check

Résultat attendu (extrait JSON) :

{
  "software": {
    "name": "LanguageTool",
    "version": "6.7",
    "buildDate": "2025-10-24 09:23:16 +0000"
  },
  "matches": [
    {
      "message": "Faute de frappe possible trouvée.",
      "replacements": [
        {"value": "école"},
        {"value": "écoles"}
      ],
      "offset": 11,
      "length": 6
    }
  ]
}

Format JSON plus lisible

Ajoutez | python3 -m json.tool pour formater la sortie :

curl -X POST \
  --data "text=Je vais au écolee demain." \
  --data "language=fr" \
  http://localhost:8010/v2/check | python3 -m json.tool

Configuration dans Visual Studio Code

Installer l’extension LanguageTool Linter

1. Ouvrez VS Code
2. Allez dans l’onglet Extensions (Ctrl + Shift + X)
3. Recherchez “LanguageTool Linter” (éditeur : davidlday)
4. Cliquez sur Installer

Lien direct : LanguageTool Linter sur le Marketplace

Configurer l’extension pour utiliser le serveur local

1. Ouvrir les paramètres JSON de VS Code :

   • Palette de commandes : Ctrl + Shift + P
   • Tapez : Preferences: Open Settings (JSON)

2. Ajouter la configuration suivante :

   {
     "languageToolLinter.languageTool.motherTongue": "fr",
     "languageToolLinter.languageTool.language": "fr",
     "languageToolLinter.external.url": "http://localhost:8010"
   }

3. Redémarrer VS Code pour appliquer les changements

Langues supportées

Pour changer de langue, remplacez "fr" par le code correspondant :

• "en" : anglais
• "de" : allemand
• "es" : espagnol
• "it" : italien
• "pt" : portugais

Liste complète : langues supportées par LanguageTool

Utilisation dans VS Code

Une fois configuré, l’extension fonctionne automatiquement sur vos fichiers Markdown, texte, code :

• Erreurs surlignées : rouge pour orthographe, jaune pour grammaire
• Suggestions au survol : passez la souris sur le texte surligné
• Correction en un clic : cliquez sur la suggestion pour appliquer

Exemple visuel :

Utilisation dans les navigateurs

Installation des extensions navigateur

LanguageTool propose des extensions pour tous les navigateurs principaux. Important : ces extensions se connectent par défaut au cloud LanguageTool, pas à votre serveur local.

Chrome / Edge

1. Ouvrez le Chrome Web Store
2. Cliquez sur “Ajouter à Chrome” (ou “Ajouter à Edge”)
3. L’icône LanguageTool apparaît dans la barre d’outils

Firefox

1. Ouvrez Firefox Add-ons
2. Cliquez sur “Ajouter à Firefox”
3. Confirmez l’installation

Safari

1. Ouvrez le Mac App Store
2. Recherchez “LanguageTool”
3. Installez et activez dans les préférences Safari

Fonctionnement de l’extension

L’extension corrige automatiquement les textes saisis dans :

• Champs de formulaires web
• Éditeurs en ligne (Google Docs, Medium, WordPress…)
• Emails (Gmail, Outlook web)

Affichage des erreurs :

• Rouge : fautes d’orthographe
• Jaune : erreurs grammaticales
• Bleu : suggestions stylistiques

Attention

Les extensions navigateur se connectent au cloud LanguageTool par défaut. Pour utiliser votre serveur local, configurez l’URL personnalisée dans les paramètres de l’extension (option avancée, non disponible sur toutes les versions).

Gratuit vs Premium : que choisir ?

Tableau comparatif

Fonctionnalité	Gratuit (local)	Premium cloud
Correction grammaire/orthographe	✅ Complète	✅ Complète
Détection style	✅ Basique	✅ Avancée
Reformulation IA	❌ Non	✅ Illimitée
Limite caractères	✅ Illimitée	✅ 150 000 par champ
Confidentialité	✅ 100% local	❌ Cloud
Coût	✅ Gratuit	💰 4,99€/mois (59,89€/an)
Guide de style	❌ Non	✅ Oui
Support 20+ langues	✅ Oui	✅ Oui

Glissez pour voir

Recommandations

Profil	Solution recommandée
Développeur / Ops rédigeant de la doc technique	✅ Gratuit local (confidentialité + illimité)
Rédacteur pro cherchant reformulations IA	✅ Premium (4,99€/mois)
Équipe (2-20 personnes)	✅ Teams (56,90€/utilisateur/an)
Utilisation occasionnelle	✅ Extension navigateur gratuite

Glissez pour voir

Essai Premium gratuit

LanguageTool offre un essai gratuit de la version Premium. Testez la reformulation IA avant de vous abonner : essai Premium LanguageTool

Dépannage

Problèmes courants et solutions

Symptôme	Cause probable	Solution
curl: (7) Failed to connect	Conteneur non démarré	docker compose up -d
docker: command not found	Docker non installé	Installer Docker
Extension VS Code inactive	URL locale non configurée	Ajouter "languageToolLinter.external.url": "http://localhost:8010"
Pas de correction dans VS Code	Langue mal configurée	Vérifier "languageToolLinter.languageTool.language": "fr"
Conteneur redémarre en boucle	Mémoire insuffisante	Augmenter RAM Docker ou réduire heap Java

Glissez pour voir

Commandes de diagnostic

# Vérifier que le conteneur est en cours d'exécution
docker ps --filter "name=LanguageTool"

# Voir les logs du conteneur
docker logs LanguageTool

# Tester l'API REST
curl -X POST \
  --data "text=Test de connexion." \
  --data "language=fr" \
  http://localhost:8010/v2/check

# Redémarrer le conteneur
docker restart LanguageTool

Attention

Si le test API retourne "premium": false, c’est normal : vous utilisez la version open source gratuite. Pour activer Premium, vous devez souscrire un abonnement cloud.

Bonnes pratiques

Sécurité

• Ne pas exposer le port 8010 sur internet : gardez LanguageTool en local (localhost uniquement)
• Pas de secrets dans les textes : même en local, évitez de copier des tokens/clés dans vos textes à corriger
• Pare-feu : si vous partagez sur le réseau local, filtrez l’accès par IP

Organisation

• Un conteneur par équipe : déployez sur un serveur interne partagé (changez le port si multi-instances)
• Dictionnaire personnalisé : ajoutez vos termes techniques dans les paramètres de l’extension
• Ignorer certains fichiers : configurez VS Code pour exclure les fichiers générés (.min.js, .lock)

Performance

• Heap Java : augmentez Java_Xmx si vous corrigez de très gros documents (> 50 000 mots)

• Ngrams (optionnel) : activez les modèles de langage pour détecter plus d’erreurs (téléchargement ~10 Go) :

  environment:
    - langtool_languageModel=/ngrams
  volumes:
    - ./ngrams:/ngrams

  Téléchargez les ngrams depuis LanguageTool.org

À retenir

1. LanguageTool local garantit la confidentialité : vos textes ne quittent jamais votre machine
2. Version 6.7 (octobre 2025) disponible via Docker erikvl87/languagetool:6.7
3. API REST sur le port 8010 : intégrable dans vos scripts et outils
4. Extension VS Code : correction en temps réel avec configuration simple
5. Gratuit vs Premium : version locale gratuite suffisante pour DevOps, Premium (4,99€/mois) pour reformulation IA
6. 20+ langues supportées : français, anglais, allemand, espagnol, italien…

Prochaines étapes

Documenter votre code Techniques de documentation technique et outils complémentaires

Markdown avancé Maîtriser la syntaxe Markdown pour vos documentations

Docker pour DevOps Approfondir Docker pour vos environnements de développement

Plus d’infos

• Site officiel LanguageTool
• Documentation API REST
• GitHub LanguageTool
• Image Docker erikvl87/languagetool
• Extension VS Code

×

📖 Voir la documentation →