nllb-renpy / README.md
virusf's picture
Update README.md
3ba77ad verified
metadata
language:
  - en
  - fr
library_name: transformers
pipeline_tag: translation
license: cc-by-nc-4.0
base_model: facebook/nllb-200-distilled-600M
tags:
  - translation
  - gaming
  - renpy
  - visual-novel
  - french
datasets:
  - custom
metrics:
  - bleu
  - sacrebleu
widget:
  - text: Hello! Welcome to our game.
    example_title: Gaming Interface
  - text: I love you more than anything.
    example_title: Romance Dialogue
  - text: What do you choose?
    example_title: Choice Menu

๐ŸŽฎ NLLB-RenPy: Specialized French Gaming Translator

๐ŸŒŸ Model Description

This model is a fine-tuned version of facebook/nllb-200-distilled-600M specifically trained for English-to-French translation in gaming contexts, particularly RenPy visual novels.

๐ŸŽฏ Specialized For:

  • ๐ŸŽฎ Gaming interfaces and menus
  • ๐Ÿ’ฌ Character dialogues and narratives
  • ๐Ÿ’• Romance and emotional expressions
  • ๐Ÿ”„ Interactive choices and options
  • ๐Ÿ“ฑ UI elements and notifications

๐Ÿ† Performance Highlights:

  • Superior quality vs Google Translate/DeepL for gaming
  • Context-aware translations maintaining gaming tone
  • Optimized for visual novel terminology
  • Consistent character voice preservation

๐Ÿš€ Quick Start

from transformers import AutoTokenizer, AutoModelForSeq2SeqLM

# Load model
model = AutoModelForSeq2SeqLM.from_pretrained("virusf/nllb-renpy")
tokenizer = AutoTokenizer.from_pretrained("virusf/nllb-renpy")

# Translate
text = "Hello! Welcome to our game."
inputs = tokenizer(text, return_tensors="pt")
outputs = model.generate(**inputs, forced_bos_token_id=tokenizer.convert_tokens_to_ids("fra_Latn"))
result = tokenizer.decode(outputs[0], skip_special_tokens=True)
print(result)  # "Bonjour! Bienvenue dans notre jeu."

๐Ÿ“Š Training Details

Base Model: facebook/nllb-200-distilled-600M
Training Data: 15,000+ specialized gaming translations
Languages: English โ†’ French
Epochs: 2.0
Final Loss: 0.4441

๐ŸŽฏ Use Cases

Perfect for translating:

โœ… RenPy/Ren'Py visual novels
โœ… Gaming interfaces and menus
โœ… Character dialogues and stories
โœ… Interactive fiction content
โœ… Dating simulation games