---
license: gemma
language:
- ja
- ko
base_model:
- google/gemma-3-12b-pt
pipeline_tag: translation
tags:
- axolotl
---

# ja-ko-vn-12b V2

<!-- Provide a quick summary of what the model is/does. -->

<p align="center">
<picture>
  <img src="https://huggingface.co/hell0ks/ja-ko-vn-12b-v2/resolve/main/assets/jako-icon.png" alt="Main icon", style="width: 50%;">
</picture>
</p>

This model translates text from Japanese visual novels or various games into Korean.

이 모델은 일본어로 된 비주얼 노벨 혹은 다양한 게임의 텍스트를 한국어로 번역합니다.

## Updates

* 2025/12/13 - Model upload
* 2025/12/13 - 모델 업로드

## Model Details

### Model Description

Google의 Gemma 3 12B 모델을 기반으로 하여 비주얼 노벨 등 게임류에 적합한 번역을 하도록 다음 절차를 거쳤습니다:

1. 일본어, 한국어에 대한 문학 계열 도메인 언어 학습 (CPT)
2. 비주얼 노벨의 원문과 번역문 학습 (SFT)
3. 특정 상황 및 단어에 대한 도메인 학습 (DPO)

주로 "직역"을 선호하시는 분께 적합합니다.

- **Developed by:** hell0ks
- **Model type:** Translation
- **Language(s) (NLP):** Japanese(Input), Korean(Output)
- **License:** Gemma
- **Finetuned from model :** [google/gemma-3-12b-pt](https://huggingface.co/google/gemma-3-12b-pt)
- **Max context length :** 4096 (까지만 테스트 됨)

#### V1과의 차이점

- Base model이 Tri-7B에서 Gemma-3-12B로 변경되었습니다.
- CPT, DPO 학습을 통해 좀 더 자연스러운 어휘를 사용하도록 유도했습니다.
- 고유 명사 고정 기능이 불완전한 상태로 릴리즈 된 것을 수정했습니다.

### Model Sources

<!-- Provide the basic links for the model. -->

- **Repository:** [hell0ks/ja-ko-vn-12b-v2](https://huggingface.co/hell0ks/ja-ko-vn-12b-v2)

## Uses

<!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->

* Temperature: 0.1, Top_k = 0.95, repetition_penalty 1.05 ~ 1.1를 추천드립니다.
* 고유 명사, 이름 등은 System prompt로 힌트를 주실 수 있습니다. 예: `岡部倫太郎=오카베 린타로,阿万音鈴羽=아마네 스즈하`
* 프롬프트는 **일본어 원문만** 입력하세요. 제어 코드나 특수문자도 최대한 그대로 유지하도록 학습되었습니다.
* Chat 모드로 사용하지 마시고, **Completions 모드로 사용하세요.** 싱글 턴으로만 학습되었습니다.

### Direct Use

* vllm, Transformers로 서빙하여 타 게임 플러그인 (XUnityTranslator)등과 사용하실 수 있습니다.

### Out-of-Scope Use

<!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
* 번역의 정확성이 크게 중요하지 않은 작업에만 사용하세요.

## Bias, Risks, and Limitations

* 일본어에서 한국어 번역만 지원합니다. 반대나 다른 언어는 지원하지 않습니다.
* Safety RL이 되지 않았습니다. 유저가 입력한 대사에 대해 그대로 번역합니다.

### Recommendations

<!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->

* 사용자(직접 및 하위 사용자 모두)는 모델의 위험성, 편향성 및 한계점을 인지해야 합니다.
* 긴 텍스트를 번역해야 하는 경우 문단 혹은 문장 단위로 이용하시는 것을 추천드립니다.

## Technical Specifications

#### Hardware

Nvidia DGX Spark, 2 Nodes

#### Software

Axolotl

## Acknowledgement

학습 하드웨어를 대가 없이 지원해주신 익명의 분께 감사 인사 드립니다.