README.md

---
title: MADLAD-400 Translation
emoji: 🌍
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 6.8.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: Translate English text to 22 production-ready languages.
---

# MADLAD-400 Translation

Translate English text to 22 production-ready languages (BLEU 35+ both directions, Section A.10) using Google's [MADLAD-400](https://arxiv.org/pdf/2309.04662) 3B model.

## Requirements

- Python 3.12
- CUDA GPU (recommended) or CPU

## Setup

```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python app.py
```

The Gradio interface launches at `http://localhost:7860`.

## Tooling

```bash
ruff check .             # lint
ruff format .            # format
ty check                 # type check
pytest -m "not slow"     # 45 fast tests
pytest                   # all 55 tests (slow require CUDA + model download)
```