Votre première traduction.

Ce que vous allez configurer

EveryLocale exécute un service en arrière-plan et un espace de travail navigateur ensemble. Le service traduit ; l'espace de travail vous permet de choisir les langues et de gérer la révision. Vous allez créer un projet, traduire trois messages anglais en allemand et télécharger un fichier JSON avec les mêmes clés et variables.

Vous avez besoin de Node.js 22.16 ou version ultérieure, pnpm 9.15.9 et d'un accès à un modèle cloud ou local. EveryLocale est un logiciel libre ; les demandes de modèle cloud utilisent le crédit de votre fournisseur.

1. Installez et créez vos paramètres

Ouvrez un terminal et exécutez ces commandes. Elles téléchargent EveryLocale et créent un fichier de paramètres privés nommé .env dans son dossier.

git clone --branch develop https://github.com/bomsn/EveryLocale.git
cd EveryLocale
pnpm install --frozen-lockfile
pnpm build
pnpm run setup

Ouvrez .env dans un éditeur de texte. L'installation a déjà généré votre jeton de connexion à l'espace de travail et un secret de session distinct. Gardez-les privés. Si le fichier existe déjà, ouvrez-le plutôt que de relancer l'installation.

2. Choisissez les modèles

Une requête crée une traduction ; une requête distincte en examine le sens et la formulation. Vous pouvez utiliser le même modèle pour les deux rôles. Cet exemple utilise Claude Sonnet 4.6 via OpenRouter. Remplacez les paramètres correspondants dans .env et mettez votre propre clé API OpenRouter dans les deux champs de clé.

EVERYLOCALE_GENERATOR_URL=https://openrouter.ai/api/v1
EVERYLOCALE_GENERATOR_KEY=YOUR_OPENROUTER_KEY
EVERYLOCALE_GENERATOR_MODEL=anthropic/claude-sonnet-4.6
EVERYLOCALE_GENERATOR_INPUT_PRICE=3
EVERYLOCALE_GENERATOR_OUTPUT_PRICE=15
EVERYLOCALE_REVIEWER_URL=https://openrouter.ai/api/v1
EVERYLOCALE_REVIEWER_KEY=YOUR_OPENROUTER_KEY
EVERYLOCALE_REVIEWER_MODEL=anthropic/claude-sonnet-4.6
EVERYLOCALE_REVIEWER_INPUT_PRICE=3
EVERYLOCALE_REVIEWER_OUTPUT_PRICE=15

Les prix sont en dollars américains par million de jetons. Vérifiez les tarifs actuels du modèle avant de traduire. Ces paramètres aident EveryLocale à budgéter les requêtes ; ils ne modifient pas la facture du fournisseur. Vous pouvez choisir un autre modèle cloud ou un point d’accès local dans le guide des paramètres du modèle.

3. Vérifiez les paramètres et ouvrez l'espace de travail

pnpm doctor
pnpm start

Doctor vérifie votre configuration et votre base de données sans effectuer de requête payante. S'il signale un paramètre manquant, corrigez-le et relancez Doctor. Gardez le terminal de service ouvert, puis visitez http://localhost:4310 dans votre navigateur.

Connectez-vous avec EVERYLOCALE_ADMIN_TOKEN depuis .env. Votre première traduction vérifiera l'accès réel au fournisseur ; une vérification de configuration seule ne peut pas vérifier une clé API.

4. Créez votre premier projet

Choisissez New project. Nommez-le My first app, utilisez first-app comme identifiant et conservez l'anglais comme langue d'origine. Sélectionnez l'allemand et décochez les autres cases de langue cible pour ce premier essai. Définissez un budget de traduction total de 1 $.

Sélectionnez Automatic approval. Les traductions qui passent les contrôles peuvent être téléchargées après les vérifications et l'examen par IA. Les problèmes importants restent en attente de traitement. Choisissez Human review gate à la place si vous souhaitez approuver vous-même chaque résultat.

5. Traduisez l'exemple

Ouvrez Content → Add content, choisissez Use sample messages et conservez le nom du contenu messages et le format JSON. L'exemple contient :

{
  "welcome": "Welcome, {name}!",
  "createProject": "Create a project",
  "saved": "Your changes are saved."
}

Choisissez Import content. L’import stocke le texte anglais sans appeler de modèle. Sélectionnez l’allemand pour ce contenu, puis choisissez Translate changes. Ouvrez Review pour suivre la progression et examiner les éventuels problèmes détectés.

En mode automatique, un résultat propre est approuvé. Si l'examen détecte un problème, corrigez le libellé et enregistrez-le pour un nouvel examen. Les projets avec validation humaine nécessitent votre approbation avant le téléchargement.

6. Télécharger et essayer une modification

Retournez à Content, ouvrez messages, sélectionnez l'allemand et choisissez Download approved. Le JSON conserve les mêmes clés et préserve {name}. Votre application peut remplacer cette variable par le nom d'une personne.

Previewcompare les fichiers complets. Connect → Export approved télécharge un catalogue avec les informations d'approbation pour le runtime EveryLocale ; Download approved vous donne le format de fichier original.

Modifiez maintenant l'exemple original, réimportez-le avec le même nom de contenu et choisissez Translate changes. Seul le texte modifié nécessite un nouveau travail. Une fois approuvé, téléchargez le fichier mis à jour.

Si quelque chose nécessite votre attention

• Traduction indisponible : configurez les deux modèles, exécutez pnpm doctor et redémarrez.
• Erreur du fournisseur : vérifiez la clé, le modèle, le point d’accès et le crédit disponible ; corrigez la cause et réessayez le travail échoué.
• Budget épuisé : inspectez les dépenses enregistrées avant d'augmenter la limite totale du projet.
• Téléchargement incomplet : terminez l'examen de chaque message actuel dans la langue sélectionnée.

Le guide complet de démarrage couvre le dépannage de l'installation. Pour un serveur partagé ou Docker, utilisez le guide d'hébergement et de récupération après votre première traduction.