Difference between revisions of "Sugoi"
(→Notable Era Quirks) |
(Update for newer versions of sugoi and update some links) |
||
| Line 1: | Line 1: | ||
== Whatis == | == 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 [https://github.com/leminhyen2/Sugoi-Japanese-Translator here] but it's outdated. You can get the newest versions from the [https:// | + | 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 [https://github.com/leminhyen2/Sugoi-Japanese-Translator here] but it's outdated. You can get the newest versions from the [https://sugoitoolkit.com/ website], [https://www.patreon.com/mingshiba the developer's patreon] or the [https://discord.gg/XFbWSjMHJh developer's discord], keep in mind the model required for offline translation is included in the download which can be bi. |
| − | |||
== Installing == | == Installing == | ||
Sugoi is built for Windows 10. For Windows 7 users: You need [https://docs.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170 Visual C++ 10, 13 and 15~22 x86 & x64 versions.] This program does not work on x86 systems. | Sugoi is built for Windows 10. For Windows 7 users: You need [https://docs.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170 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 | + | Installation procedure probably won't change between versions, check the Patreon or the website for newer versions. |
| − | + | :1. Download [https://drive.google.com/file/d/1VjJZQXcV8pvuTijm071oDE3GrY47R7bG/view?usp=sharing] | |
| − | :1. Download [https://drive.google.com/file/d/ | ||
:2. Extract to wherever | :2. Extract to wherever | ||
| − | :3. Launch via <code>Sugoi- | + | === Online Method === |
| − | + | :3. Launch via <code>Sugoi-Toolkit (click here).bat</code> and select an online translation method, for era games use <code>Sugoi Translator DeepL</code> or <code>Sugoi Translator Papago</code> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | '''Read before using:''' The offline version of this program | + | === Offline Method === |
| + | :3. Launch via <code>Sugoi-Toolkit (click here).bat</code> and select <code>Sugoi Translator Offline</code> | ||
| + | '''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 ==== | ==== Using CUDA to Improve Performance of Offline Version ==== | ||
| Line 33: | Line 23: | ||
===== Method 1: Using a premade powershell script ===== | ===== Method 1: Using a premade powershell script ===== | ||
| − | [https://cdn.discordapp.com/attachments/795551389211164703/ | + | [https://cdn.discordapp.com/attachments/795551389211164703/1093241615377764472/CudaInstallForToolKit5.zip 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 <code><your Sugoi Directory>\Power-Source\Python39</code> | |
| − | 1. Open command prompt | ||
2. Type: | 2. Type: | ||
| − | + | <code>python.exe -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 --upgrade</code> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
3. In <code>backendServer\Program-Backend\Sugoi-Translator-Offline\offlineTranslation\fairseq\flaskServer.py</code> change line 19 <code># ja2en.cuda()</code> to <code>ja2en.cuda()</code> | 3. In <code>backendServer\Program-Backend\Sugoi-Translator-Offline\offlineTranslation\fairseq\flaskServer.py</code> change line 19 <code># ja2en.cuda()</code> to <code>ja2en.cuda()</code> | ||
| − | ===== Method 3: Manually upgrade by pip using global python installation on Windows===== | + | ===== Method 3: Manually upgrade by pip using global python installation on Windows (Not recommended)===== |
| − | 1. Open command prompt | + | 1. Open command prompt or powershell |
| − | + | 2. Type: | |
| − | + | <code>pip install --target=<your Sugoi Directory>\Power-Source\Python39\Lib\site-packages torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 --upgrade</code> | |
| − | |||
| − | |||
| − | |||
| − | 2. Change line 19 in <code>backendServer\Program-Backend\Sugoi-Translator-Offline\offlineTranslation\fairseq\flaskServer.py</code> from <code># ja2en.cuda()</code> to <code>ja2en.cuda()</code> | + | 2. Change line 19(may vary a bit depending on version) in <code>backendServer\Program-Backend\Sugoi-Translator-Offline\offlineTranslation\fairseq\flaskServer.py</code> from <code># ja2en.cuda()</code> to <code>ja2en.cuda()</code> |
== Notable Era Quirks == | == 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) | (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. | + | *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:// | + | ** 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. | *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. | *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. | ||
Revision as of 12:00, 31 May 2023
Contents
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 or the developer's discord, keep in mind the model required for offline translation is included in the download which can be bi.
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).batand select an online translation method, for era games useSugoi Translator DeepLorSugoi Translator Papago
Offline Method
- 3. Launch via
Sugoi-Toolkit (click here).batand selectSugoi 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-Translator-Offline\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-Translator-Offline\offlineTranslation\fairseq\flaskServer.py from # ja2en.cuda() to ja2en.cuda()
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.
