In-App Settings
Configure Karpa from the settings page: providers, appearance, notifications, and data.
The Settings page lets you tweak everything at runtime. No file editing,
no restarts. Open it from the sidebar or press Ctrl+,.
Appearance
| Setting | Options |
|---|---|
| Theme | Light, Dark, System (follows your OS), plus an AMOLED-friendly pure-black variant. |
| Interface Language | English, Türkçe, Deutsch, Français, Español. |
Your theme and language choices are remembered across sessions.
Connection
Karpa supports multiple AI backends. Select yours from the provider grid.
Supported Providers
| Provider | Type | Requires API Key | Default Model |
|---|---|---|---|
| LM Studio | Local | No | You pick from your loaded models |
| Ollama | Local | No | You pick from your pulled models |
| OpenAI | Cloud | Yes | gpt-4o-mini |
| Anthropic | Cloud | Yes | claude-sonnet-4-20250514 |
| Google Gemini | Cloud | Yes | gemini-2.0-flash |
| OpenRouter | Cloud | Yes | amazon/nova-2-lite-v1 |
| Custom | Cloud/Local | Optional | Any OpenAI-compatible endpoint |
Fields per provider
- API URL: defaults to the provider's standard endpoint (
http://localhost:1234for LM Studio,http://localhost:11434for Ollama). Change it if you use a custom host or proxy. - API Key: shown only for providers that require one. It is kept in session storage and cleared when you close the browser.
- Model: pick from models auto-fetched from your endpoint, from a curated known-models list, or type an identifier manually in the model picker dialog.
- Temperature: slide between
0.0(deterministic) and1.0(creative). Default is0.2, which favors faithful translations.
Click Test Connection to verify before saving.
Notifications
| Setting | Description |
|---|---|
| Desktop Notifications | Show a system notification when a translation finishes. |
| Sound Effect | Play a short chime when a translation completes. |
Grant notification permission when your browser asks. Notifications also fire while the tab is in the background.
Data
The Data tab manages what the docs call the Translation Vault: everything Karpa has stored locally.
| Action | Description |
|---|---|
| Export Data | Download history, favorites, and settings as a JSON backup. |
| Import Data | Restore from a previously exported backup. |
| Clear All Data | Permanently delete all history and favorites. |
| Reset Settings / Onboarding | Restore defaults or replay the welcome tour. |
See Data & Storage for exactly where each piece of data lives.
About
Shows the current Karpa version, developer information (Eren Çakar), and links to the GitHub repository.
Tips
- Cloud providers: API keys live in session storage only. You will need to re-enter a key after closing the browser; that is by design.
- Local providers: start LM Studio or Ollama before testing the connection.
- Model names must match your provider exactly. If auto-fetch finds no models, check that the server is running and the URL is correct.