Sugoi

This guide is OLD. It should still work but needs revamped for modern versions of Sugoi.

Whatis

Sugoi is a translation tool made by leminhyen2 on github. It reads from your clipboard and automatically translates through your choice of DeepL, Papago, or his homebrewed AI based translation model. The repo for the program is here but it's outdated. You can get the newest versions from the website, the developer's patreon, developer's discord or Archive.org keep in mind the model required for offline translation is included in the download.

Installing

Sugoi is built for Windows 10. For Windows 7 users: You need Visual C++ 10, 13 and 15~22 x86 & x64 versions. This program does not work on x86 systems.

Installation procedure probably won't change between versions, check the Patreon or the website for newer versions.

1. Download [1]

2. Extract to wherever

Online Method

3. Launch via Sugoi-Toolkit (click here).bat and select an online translation method, for era games use Sugoi Translator DeepL or Sugoi Translator Papago

Offline Method

3. Launch via Sugoi-Toolkit (click here).bat and select Sugoi Translator Offline

Read before using: The offline version of this program requires 8 GB of RAM to run. Very CPU intensive unless you do the steps below.

Using CUDA to Improve Performance of Offline Version

IMPORTANT: WORKS FOR NVIDIA GPUs ONLY

Before doing anything, check in NVIDIA control panel > system information > component tab and see what CUDA version you have. v3.xx only works with CUDA v11.xx+, 2.0 works with CUDA 10.xx

Method 1: Using a premade powershell script

Download & read the included "readme.txt" file

Method 2: Manually upgrade by pip using python included in Sugoi

1. Open command prompt or powershell and go to <your Sugoi Directory>\Power-Source\Python39

2. Type: python.exe -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 --upgrade

3. In backendServer\Program-Backend\Sugoi-Japanese-Translator\offlineTranslation\fairseq\flaskServer.py change line 19 # ja2en.cuda() to ja2en.cuda()

Method 3: Manually upgrade by pip using global python installation on Windows (Not recommended)

1. Open command prompt or powershell

2. Type: pip install --target=<your Sugoi Directory>\Power-Source\Python39\Lib\site-packages torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 --upgrade

2. Change line 19(may vary a bit depending on version) in backendServer\Program-Backend\Sugoi-Japanese-Translator\offlineTranslation\fairseq\flaskServer.py from # ja2en.cuda() to ja2en.cuda()

Running on Linux

Sugoi itself doesn't run on Linux (even through Wine), but you can use the models through [sugee] and [sugoi-web]

1. git clone sugee.

2. Create a Python 3.9 venv and activate it:

python3.9 -m venv venv

source venv/bin/activate

3. Follow the sugee installation instructions in the readme.

4. Run sugoi-web and follow the instructions on the page.

Notable Era Quirks

(If anyone finds anything that should be in this section mention Harris#0425 on discord or post in the plw thread for it to be added)

• By default, this only attempts to translate copied text that contains a Japanese character. Not a problem for it's original purpose, which was for translating VN's, but with text games you run into the unique problem of ASCII menus and world maps, which invariably contain at least one character that'll set it off, making it try to translate hundreds of gibberish characters and gangraping all your CPU cores. With in i7-8700 and no CUDA the bamboo forest map in TW locked my entire computer up for a good ten seconds and my cooling fans made a solid attempt at takeoff. https://gitgud.io/CMD32bit/era-clipboard
  • Please download this autohotkey script: https://gitgud.io/CMD32bit/era-clipboard (you can use the compiled exe version if you want) to use with Sugoi to avoid the above scenario.
• Sugoi (and DeepL) really do not like mixed language inputs. If it's only one or two words it should be fine but if multiple sentences sneak in there's a good chance it'll get confused and print nothing, or just give you the english back and drop the JP text entirely. If you see this happen, just open your log and re-copy the Japanese manually.
• Anyone that's used DeepL for a while has experienced that 'thing' it does, where instead of translating what you gave it it goes, "It’s a good idea to have a good idea of what you’re looking for" or "I'm sure you will find a way to make it work for you." or shit like that. It's a quirk of how the AI was trained or something. The online version of Sugoi suffers from this, since it's basically just a fancy DeepL client, but the Offline version never does this.

Additional resources

• Model files: To install them you need to need to replace file big.pretrain.pt in folder: \backendServer\Program-Backend\Sugoi-Japanese-Translator\offlineTranslation\fairseq\japaneseModel .
  • Sugoi tools V.6 download