Skip to main content
The translation picker combines local and hosted backends. A selection records the provider, model ID, optional local quantization, and vision-input setting.

Available connections

Each provider owns its endpoint defaults, request mapping, and model discovery. Available models can change independently of these docs.
1

Save the connection

Open Settings → Providers, choose a provider, and fill in its fields. Hosted services require credentials. A local compatible server needs its base URL; whether it needs a secret depends on that server.
2

Select a model

Open the processing selector or Settings → Translation. Opening the model picker refreshes provider discovery. An unreachable provider may have no discovered models even while its saved settings remain intact.
3

Choose whether to include the page image

Enable Vision input only for a model that accepts images. Cataloged text-only models disable the switch. OpenAI-compatible endpoints are user-declared, so verify the endpoint and model support image messages.
4

Try one page

Check the source OCR, run translation on the current page, and review the response before processing a chapter.

Credentials and privacy

Provider secrets use the operating system’s secure credential service. Non-secret endpoint settings live in ~/.koharu/config.toml. Local models keep prompts and text on your machine after download. Hosted providers receive request content and apply their own retention terms. Local detection and OCR do not make a hosted translation request local.
Keep keys out of project instructions, text layers, and configuration files. Save credentials through Settings → Providers.