Your first translation.

Start on your computer, translate a small file, and see exactly what your app will receive.

On this page

What you will set up

EveryLocale runs a background service and a browser workspace together. The service translates; the workspace lets you choose languages and handle review. You will create one project, translate three English messages into German, and download a JSON file with the same keys and variables.

You need Node.js 22.16 or later, pnpm 9.15.9, and access to a cloud or local model. EveryLocale is free software; cloud model requests use your provider's credit.

1. Install and create your settings

Open a terminal and run these commands. They download EveryLocale and create a private settings file named .env in its folder.

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

Open .env in a text editor. Setup has already generated your workspace sign-in token and a separate session secret. Keep them private. If the file already exists, open it rather than running setup again.

2. Choose the models

One request creates a translation; a separate request reviews its meaning and wording. You can use the same model for both roles. This example uses Claude Sonnet 4.6 through OpenRouter. Replace the matching settings in .env, and put your own OpenRouter API key in both key fields.

Model settings
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

Prices are US dollars per million tokens. Check the model's current rates before translating. These settings help EveryLocale budget requests; they do not change the provider's bill. You can choose another cloud model or a local endpoint in the model settings guide.

3. Check settings and open the workspace

Terminal
pnpm doctor
pnpm start

Doctor checks your configuration and database without making a paid request. If it reports a missing setting, fix that setting and run it again. Keep the service terminal open, then visit http://localhost:4310 in your browser.

Sign in with EVERYLOCALE_ADMIN_TOKEN from .env. Your first translation will verify actual provider access; a configuration check alone cannot verify an API key.

4. Create your first project

Choose New project. Name it My first app, use first-app as its identifier, and keep English as the original language. Select German and clear the other target-language checkboxes for this first trial. Set a total translation budget of $1.

Select Automatic approval. Clean translations can be downloaded after checks and AI review. Material issues still wait for attention. Choose Human review gate instead if you want to approve every result yourself.

EveryLocale workspace showing an example project's language coverage and review action

5. Translate the sample

Open Content → Add content, choose Use sample messages, and keep the content name messages and JSON format. The sample contains:

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

Choose Import content. Import stores the English text and does not call a model. Select German for this content, then choose Translate changes. Open Review to follow progress and inspect any findings.

In automatic mode, a clean result becomes approved. If review finds a problem, correct the wording and save it for another review. Human-gated projects need your approval before download.

6. Download and try a change

Return to Content, open messages, select German, and choose Download approved. The JSON keeps the same keys and preserves {name}. Your app can replace that variable with a person's name.

Preview compares the complete files. Connect → Export approved downloads a catalog with approval information for the EveryLocale runtime; Download approved gives you the original file format.

Now edit the original sample, reimport it with the same content name, and choose Translate changes. Only changed text needs new work. Once approved, download the updated file.

Use this in your app

If something needs attention

  • Translation unavailable: configure both models, run pnpm doctor, and restart.
  • Provider error: check the key, model, endpoint, and available credit; fix the cause and retry the failed job.
  • Budget exhausted: inspect recorded spending before raising the project's total limit.
  • Download incomplete: finish review for every current message in the selected language.

The complete getting-started guide covers installation troubleshooting. For a shared server or Docker, use the hosting and recovery guide after your first translation works.