NanumOS

Translate

Status: In trial

Korean ↔ English translation, on this computer or with your own API key.

Translate

About this app

Put the text on the left and press [Translate]: the translation comes on the right, paragraph by paragraph. Paste, open a .txt or .md file, or type. Copy the translation, or press 🔊 to hear it read sentence by sentence. It is an app of its own, apart from the Dictionary.

At a glance

In one line: An app that turns Korean into English and back. By default it works on this computer.

The screen

Task 1. Translate one sentence

  1. Type a sentence in the box below
  2. Press Enter
  3. Press Enter once more

Say: "Translate Good morning into Korean"

Task 2. Translate a file

  1. Press Open file...
  2. Choose a .txt file
  3. Press Translate
  4. For a long text, press Allow

Say: "Translate Hello into English"

Task 3. Take the translation with you

  1. Press Copy
  2. Paste it where you need it

Say: "Open the Translate app"

Basics

You choose where it translates. "On this computer" (the default) sends not a single character anywhere and costs nothing — in the NanumOS app on a Mac the Mac's own translator (Apple) does it; on other computers a model inside NanumOS does. "My API key" uses a model on the internet with your own key: fast everywhere, but the text goes to that provider and you pay for it. Like using the dictionary at home versus paying a translator. What to do now: paste a short sentence and press [Translate].

How to use it

  1. Put the text in: [Paste], [Open file…] (Ctrl+O), or type in the line below and press Enter (it adds a paragraph).
  2. The direction follows the text (mostly Hangul = Korean → English). To change it, press "Korean → English ⇄" at the top.
  3. Press [Translate] (Enter on the empty line, or Ctrl+Enter). The translation appears paragraph by paragraph; the line below shows the progress. [Stop] or Esc stops it.
  4. A long text (over 3,000 characters by default) with the model inside NanumOS or your key first shows the card "Translate a long text?" with the characters, model, estimated cost and time, and where the text goes. It starts only after [Allow].
  5. [Copy] puts the translation on the clipboard; [🔊 Read aloud] reads it.
  6. Settings: Ctrl+,, or press the engine words at the top. Ctrl+W closes. The text you put in is still there when you open the app again.

How it works

When you press [Translate], the translation runs in the background. The text goes one paragraph (a long paragraph: a piece cut at sentence ends) at a time, and each finished piece is added to the screen at once. So you can keep using other windows and typing while it works.

Why is "On this computer" the default? Your text goes nowhere and nothing runs on anyone's money. On a Mac, the Mac's translator does 10,000 characters in about ten seconds. On other computers it is slow for now: NanumOS still runs the model on one core, so a 4B model can take minutes for one paragraph; the long-text card shows the estimated time (running it on several cores is in progress).

Code stops surprise bills. Even with your key, the engine checks three things before anything is sent: (1) characters per request (2,000 by default and at most), (2) a daily cost limit (50 cents by default), (3) the approval card for a long text. Past a limit nothing is sent and the app says why. [Allow] makes a one-time ticket for that text and that model only, so neither the assistant nor a model can press it for you.

The key lives only in the vault. You type it once into a dotted field; it goes straight into the vault (entry TRANSLATE_KEY) and is never shown again. Even the engine never sees it — the vault's broker (secret-http) attaches it at the moment of sending. The first time, the vault asks "Let Translate use this key?".

Technical details
  • App src/gui/translate.c, engine user/zeus/translate.py, contract docs/contracts/TRANSLATE.md.
  • NanumOS app on a Mac: the Mac's Translation framework (on-device, macOS 26+, Korean and English downloaded in System Settings › General › Language & Region › Translation Languages). Pieces go to the Mac app as vtr lines and only the translation comes back (tools/macvz/host_translate.swift).
  • Other computers: the pack's llama -serve (llama.cpp b6900, one thread); Apache-2.0 models only (Qwen3-4B-Instruct-2507, tools/translate/models.tsv, hash-pinned, never in the repository).

FAQ

Why is it slow?

"On this computer" on a computer that is not a Mac runs the model on one core. For speed, pick "My API key" in Settings › Translate (under one cent and some tens of seconds for 10,000 characters).

How accurate is the Mac's translator?

Sentences pass our bar. When you need it more accurate, use "My API key".

What does my key cost?

Can it do a whole book?

Up to 600,000 characters. It starts only after [Allow] on the card that shows the estimated cost and time.

Can I ask the assistant to translate?

Yes. Say "translate this into English" and the assistant puts the text into Translate and starts it. A long text brings up the same approval card, which a person has to press.

Try this

1. Translate a sentence

  1. Type Good morning. The weather is nice today. in the line below, press Enter, then Enter again.

Translate a sentence 1

2. A long text and the card

  1. Open a long .txt file and press [Translate]: the card comes up. Look at the time and press [Allow] or [Cancel].

A long text and the card 1

3. What it takes

  1. Press [What it takes] at the top: one screen says what this app sends and where.

What it takes 1

Shortcuts

Enter on the empty line or Ctrl+Enter: translate · Esc: stop · Ctrl+O: open a file · Ctrl+,: settings · Ctrl+W: close.

Settings

Settings › Apps › Translate: "Engine" (On this computer · My API key), "Model (my key)", "API key" (press to enter it), "Daily cost limit (cents)" (50), "Characters per request" (2,000, at most 2,000), "Ask first above (characters)" (3,000), Custom URL and model name.

What it cannot do

Only Korean ↔ English can be picked for now. On-device translation on computers other than a Mac is slow. The phone page does not translate (the desktop does).

NanumOS 0.1.8349 · 2026-11-16