BabelizeBabelize
Getting Started

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.

Install the Babelize CLI and set up your environment in under a minute.

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/cli

Or run directly without installing:

npx @babelize/cli --help

Make sure everything works:

babelize --version

You should see the installed version number.

Authenticate with your Babelize account:

babelize auth login

This prompts for your email and password. Pass --github, --google, or --gitlab to sign in with OAuth instead (opens your browser). 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/sdk
pnpm add @babelize/sdk
yarn add @babelize/sdk
bun add @babelize/sdk

For React applications, import the React bindings from the SDK's /react subpath — no extra install:

npm install @babelize/sdk

And add the build plugin for automatic lockfile generation:

npm install -D @babelize/vite

See 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/mcp

Or run on-demand without installing:

npx -y @babelize/mcp

Set your API key:

export BABELIZE_API_KEY=bblz_sk_xxxxxxxxx

See the MCP Server guide for configuration with Cursor, Claude, and other AI tools.

What's Next?

Last updated: 2026-10-16

How is this guide?

On this page