Installation
Install the Babelize CLI, the SDK packages and the MCP server: prerequisites, install commands for each tool, and the next step for your project.
To translate a project, you don't need to install anything. In your project folder, run:
npx babelizeIt checks git, detects your framework and source language, opens your browser to sign in, asks which languages you want, and writes the locale files and i18n setup into your project. See First Translation.
Install the CLI globally if you'll use its other commands (cloud babels, pull requests, project management), and the SDK or MCP server if you need them.
Prerequisites
Node.js 22+
The Babelize CLI requires Node.js 22 or later (`engines.node >= 22`). Check with `node --version`.
GitHub Account
Only needed to connect repositories — you can skip it and upload a ZIP instead.
Install the CLI
Install globally so you can use babelize from anywhere:
npm install -g @babelize/cliOr run any command without installing (npx babelize and npx @babelize/cli run the same CLI):
npx babelize --helpMake sure everything works:
babelize --versionYou should see the installed version number.
Authenticate with your Babelize account:
babelize auth loginIt asks how you want to sign in: GitHub, Google or email. Pass --github or --google to go straight to the browser sign-in, or --email (and --password in CI) for email. If you don't have an account yet, create one for free.
Install the SDK
The Babelize SDK lets you translate strings directly in your application at runtime. In the browser it reads translations from a build-time lockfile (generated by the build plugin below); pass an API key only in server-side code.
npm install @babelize/sdkpnpm add @babelize/sdkyarn add @babelize/sdkbun add @babelize/sdkFor React applications, import the React bindings from the SDK's /react subpath — no extra install:
npm install @babelize/sdkAnd add the build plugin for automatic lockfile generation:
npm install -D @babelize/viteSee the SDK documentation for a complete guide to setting up translations in your app.
Install the MCP Server
The MCP (Model Context Protocol) server lets AI coding agents like Cursor, Claude Desktop, and opencode interact with Babelize directly from your editor.
npm install -g @babelize/mcpOr run on-demand without installing:
npx -y @babelize/mcpSet your API key:
export BABELIZE_API_KEY=bblz_sk_xxxxxxxxxSee the MCP Server guide for configuration with Cursor, Claude, and other AI tools.
What's Next?
Last updated: 2026-11-01
Introduction
Babelize is AI localization that translates React, Next.js, Django and static HTML apps into 90+ languages and opens a GitHub PR with ready locale files.
Create an Account
Sign up for Babelize with GitHub (recommended), email or Google, and see what to do next once your account is ready to run its first translation.