Common issues
If something does not work as expected, check these points first.
The app will not translate, rewrite, or transform
Section titled “The app will not translate, rewrite, or transform”Check that:
- you have selected a preset (Easy) or model (Advanced) in the toolbar
- in Easy mode, Settings → General Settings has a Provider with a working key (or Local LLM URL)
- in Advanced mode, a model is selected in the toolbar (an empty list is allowed, but you need at least one model in Settings → Models to run)
- your API setup is working (desktop: Settings → API Config → Test)
The model list is empty
Section titled “The model list is empty”In Easy mode, confirm Provider is set and keys/URLs are tested. For Local LLM, ensure your local server is running and models are loaded.
In Advanced mode, selected models may be empty. Open Settings → Models, click Refresh, and add models to Selected Models. Optionally turn on Free Only. Removing the last toolbar model also opens Settings → Models.
Too slow or too expensive
Section titled “Too slow or too expensive”- Choose a different preset or model
- Use shorter input
- Turn off Real-time translation while typing in General Settings
- Use free models for simple tasks
Wrong interface language
Section titled “Wrong interface language”Click the globe icon in the toolbar and choose your Interface language.
Text too small or hard to read
Section titled “Text too small or hard to read”Settings → General Settings → change Font Family and Size.
Dashboard Summary looks empty
Section titled “Dashboard Summary looks empty”This is normal if:
- you only use free models and you are looking at cost figures (they may be zero); call-count KPIs still need data for the selected period
- the selected time filter does not cover when calls were made — try All
If KPIs are still zero after All, check History or Dashboard → All Calls.
Cost shows “not available” or seems wrong
Section titled “Cost shows “not available” or seems wrong”OpenRouter shows actual spend when applicable. For other providers, cost is estimated from OpenRouter pricing; if no price matches, cost shows as not available and is not added to the total.
Total cost does not match my provider bill
Section titled “Total cost does not match my provider bill”Figures in the app are estimates for reference, not invoices. For OpenRouter, use Settings → Cost Tracking → Sync with API key usage.
History page missing from the sidebar
Section titled “History page missing from the sidebar”Keep execution history may be off. Enable it in General Settings unless history is disabled by the administrator (HISTORY_DISABLED — see Configuration).
Web: redirected to login unexpectedly
Section titled “Web: redirected to login unexpectedly”Your session may have timed out. Log in again. If it happens often, ask an administrator to increase Session Timeout under Settings → Users (an admin may also have revoked your sessions).
Web admin: forgot password
Section titled “Web admin: forgot password”If another admin can sign in, they can reset the password under Settings → Users. If you are locked out but have shell access:
docker exec transrewrt reset-web-password '<username>' '<new-password>'Default admin username is admin. From a source checkout: pnpm run reset-web-password -- <username> <new-password>.
Dashboard shows no data for other users (web)
Section titled “Dashboard shows no data for other users (web)”Only administrators can view other users via the User filter. Regular users see only their own activity.
Changed a prompt and lost edits
Section titled “Changed a prompt and lost edits”When editing a Transform prompt, click Save before Back to Run.
Quick tips
Section titled “Quick tips”- Start with Translate to confirm your setup before Rewrite or Transform
- Use Rewrite for everyday wording improvements
- Use Transform for repeatable custom workflows
- Stay on Easy mode until you need fine-grained model IDs
- Export prompts regularly if you are building a prompt library
- Use Dashboard and History to review usage and past runs