Tu primera traducción.

Lo que configurarás

EveryLocale ejecuta un servicio en segundo plano y un espacio de trabajo en el navegador juntos. El servicio traduce; el espacio de trabajo te permite elegir idiomas y gestionar la revisión. Crearás un proyecto, traducirás tres mensajes en inglés al alemán y descargarás un archivo JSON con las mismas claves y variables.

Necesitas Node.js 22.16 o posterior, pnpm 9.15.9 y acceso a un modelo en la nube o local. EveryLocale es software gratuito; las solicitudes de modelos en la nube utilizan el crédito de tu proveedor.

1. Instala y crea tu configuración

Abre una terminal y ejecuta estos comandos. Descargan EveryLocale y crean un archivo de configuración privada llamado .env en su carpeta.

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

Abre .env en un editor de texto. La configuración ya ha generado tu token de inicio de sesión del espacio de trabajo y un secreto de sesión separado. Mantenlos privados. Si el archivo ya existe, ábrelo en lugar de ejecutar la configuración de nuevo.

2. Elige los modelos

Una solicitud crea una traducción; una solicitud separada revisa su significado y redacción. Puedes usar el mismo modelo para ambos roles. Este ejemplo usa Claude Sonnet 4.6 a través de OpenRouter. Reemplaza la configuración correspondiente en .env y coloca tu propia clave de API de OpenRouter en ambos campos de clave.

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

Los precios son en dólares estadounidenses por millón de tokens. Consulta las tarifas actuales del modelo antes de traducir. Esta configuración ayuda a EveryLocale a presupuestar solicitudes; no cambia la factura del proveedor. Puedes elegir otro modelo en la nube o un punto final local en la guía de configuración de modelos.

3. Verifica la configuración y abre el espacio de trabajo

pnpm doctor
pnpm start

Doctor verifica tu configuración y base de datos sin realizar una solicitud de pago. Si reporta una configuración faltante, corrígela y ejecútalo de nuevo. Mantén la terminal de servicio abierta y luego visita http://localhost:4310 en tu navegador.

Inicia sesión con EVERYLOCALE_ADMIN_TOKEN desde .env. Tu primera traducción verificará el acceso real del proveedor; una verificación de configuración sola no puede verificar una clave de API.

4. Crea tu primer proyecto

Elige New project. Nómbralo My first app, usa first-app como su identificador y mantén el inglés como idioma original. Selecciona alemán y desactiva las otras casillas de idioma de destino para esta primera prueba. Establece un presupuesto total de traducción de $1.

Selecciona Automatic approval. Las traducciones limpias se pueden descargar después de las verificaciones y la revisión de IA. Los problemas importantes aún esperan atención. Elige Human review gate en su lugar si deseas aprobar cada resultado tú mismo.

5. Traduce la muestra

Abre Content → Add content, elige Use sample messages y mantén el nombre de contenido messages y el formato JSON. La muestra contiene:

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

Elige Import content. Import almacena el texto en inglés y no llama a un modelo. Selecciona alemán para este contenido y luego elige Translate changes. Abre Review para seguir el progreso e inspeccionar cualquier hallazgo.

En modo automático, un resultado limpio se aprueba. Si la revisión encuentra un problema, corrige la redacción y guárdalo para otra revisión. Los proyectos con control humano necesitan tu aprobación antes de descargar.

6. Descarga e intenta un cambio

Vuelve a Content, abre messages, selecciona alemán y elige Download approved. El JSON mantiene las mismas claves y preserva {name}. Tu aplicación puede reemplazar esa variable con el nombre de una persona.

Preview compara los archivos completos. Connect → Export approved descarga un catálogo con información de aprobación para el tiempo de ejecución de EveryLocale; Download approved te proporciona el formato de archivo original.

Ahora edita el ejemplo original, reimportalo con el mismo nombre de contenido y elige Translate changes. Solo el texto modificado necesita nuevo trabajo. Una vez aprobado, descarga el archivo actualizado.

Si algo necesita atención

• Traducción no disponible: configura ambos modelos, ejecuta pnpm doctor y reinicia.
• Error del proveedor: verifica la clave, el modelo, el punto de conexión y el crédito disponible; soluciona la causa e intenta de nuevo el trabajo fallido.
• Presupuesto agotado: inspecciona el gasto registrado antes de aumentar el límite total del proyecto.
• Descarga incompleta: completa la revisión de cada mensaje actual en el idioma seleccionado.

La guía completa de introducción cubre la solución de problemas de instalación. Para un servidor compartido o Docker, usa la guía de alojamiento y recuperación después de que tu primera traducción funcione.