Configuration
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 or server restarts needed. Open it from the sidebar.
Appearance
| Setting | Options |
|---|---|
| Theme | Light, Dark, or System (follows your OS). |
| 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 | — |
| Ollama | Local | No | — |
| 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 | — |
Settings per provider
- API URL — defaults to the provider's standard endpoint. Change if you're using a custom host or proxy.
- API Key — only shown for providers that require one. Stored securely in session storage (cleared when you close the browser).
- Model — pick from auto-fetched models, known model lists, or type one manually using the model picker dialog.
- Temperature — slide between
0.0(deterministic) and1.0(creative). Default:0.2. Faithful translations at0.2, more creative at higher values.
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. |
Requires notification permission to be granted in your browser. Notifications also fire when the tab is in the background.
Data
| Action | Description |
|---|---|
| Export Data | Download your history, favorites, and settings as a JSON file. |
| Import Data | Restore from a previously exported backup. |
| Clear All Data | Permanently delete all history and favorites. |
| Reset Onboarding | Show the welcome tour again on next launch. |
Your data never leaves your device — backups are stored locally.
About
Shows the current Karpa version (read from package.json), developer information
(Eren Çakar), and links to the GitHub repository.
Tips
- Cloud providers: API keys are stored in session storage and are cleared when you close the browser.
- Local providers: Make sure your server (LM Studio, Ollama) is running before testing the connection.
- Model names must match exactly — check your provider's documentation if auto-fetch doesn't find models.