Files
ComfyUI_frontend/src/locales
danialshirali16 6883241e50 Add Persian (Farsi) language support (#7876)
## Description

This PR adds Persian (Farsi) language support to ComfyUI. 

## Changes

- Added `fa` to output locales in `.i18nrc.cjs` with Persian-specific
translation guidelines
- Added Persian loaders for all translation files (main, nodeDefs,
commands, settings) in `src/i18n.ts`
- Added Persian (فارسی) option to language settings dropdown in
`src/platform/settings/constants/coreSettings.ts`
- Created empty Persian locale files in `src/locales/fa/` directory
(will be populated by the CI translation system)

## Translation Guidelines

The Persian translation will follow these guidelines:
- Use formal Persian (فارسی رسمی) for professional tone throughout the
UI
- Keep commonly used technical terms in English when they are standard
in Persian software (e.g., node, workflow)
- Use Arabic-Indic numerals (۰-۹) for numbers where appropriate
- Maintain consistency with terminology used in Persian software and
design applications

## Testing

The configuration has been tested to ensure:
- TypeScript compilation succeeds
- All four translation files are properly referenced
- Language option appears correctly in settings

## Notes

Following the contribution guidelines in `src/locales/CONTRIBUTING.md`,
the empty translation files will be automatically populated by the CI
system using OpenAI. Persian-speaking contributors can review and refine
these translations after the automated generation.

---

Special names to keep untranslated: flux, photomaker, clip, vae, cfg,
stable audio, stable cascade, stable zero, controlnet, lora, HiDream,
Civitai, Hugging Face

┆Issue is synchronized with this [Notion
page](https://www.notion.so/PR-7876-Add-Persian-Farsi-language-support-2e16d73d365081f69df0e50048ce87ba)
by [Unito](https://www.unito.io)

Co-authored-by: danialshirali16 <danialshirali16@users.noreply.github.com>
2026-01-10 23:02:16 -07:00
..
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00
2026-01-10 16:26:51 -08:00

Internationalization (i18n)

Our project supports multiple languages using vue-i18n. This allows users around the world to use the application in their preferred language.

Supported Languages

  • en (English)
  • zh (中文)
  • ru (Русский)
  • ja (日本語)
  • ko (한국어)
  • fr (Français)
  • es (Español)
  • tr (Türkçe)

How to Add a New Language

Want to add a new language to ComfyUI? See our detailed Contributing Guide with step-by-step instructions and confirmed working process.

Quick Start

  1. Open an issue or reach out on Discord to request a new language
  2. Follow the technical process or ask for help
  3. Our CI will automatically generate translations using OpenAI
  4. Become a maintainer for your language

File Structure

Each language has 4 translation files in src/locales/[language-code]/:

  • main.json - Main UI text
  • commands.json - Command descriptions
  • settings.json - Settings panel
  • nodeDefs.json - Node definitions