Getting Started
How Babelize Works
The translation pipeline — from source code to translated PR.
When you run Babelize on a project, here's what happens under the hood.
Pipeline
GitHub Repo → Code Scan → String Extraction → AI Translation → PR with Translations1. Code Scan
Babelize clones your repository and scans for translatable content:
- Detects your framework (React, Next.js)
- Finds existing i18n resource files (JSON, YAML, etc.)
- Identifies hardcoded strings in your components
2. String Extraction
Translatable strings are extracted and deduplicated:
- JSX text content
- i18n key-value pairs
- Metadata and alt text
- Variables and interpolations are preserved as placeholders
3. AI Translation
The translation engine processes each string:
- Checks your glossary for predefined translations
- Analyzes surrounding context for accuracy
- Generates translations using AI
- Ensures identical source strings get identical translations
4. Output
Babelize generates translated resource bundles and raises a PR:
.jsonor.i18nfiles per language- Clean file structure matching your project
- PR includes a diff summary of all changes
Deterministic Translations
Babelize guarantees the same input + configuration produces the same output:
- Fixed model versions — pinned per project, updated only when you opt in
- Seed-based generation — eliminates randomness between identical requests
- Configuration hashing — glossary + language pair + settings produce a stable hash
Processing Times
| Content Size | Typical Time |
|---|---|
| < 1,000 strings | Under 30 seconds |
| 1,000 – 5,000 strings | 1–3 minutes |
| 5,000+ strings | 3–10 minutes |
Times vary based on repository size, number of target languages, and current system load.