עזרה
Troubleshooting
Checking the setup with letronna doctor, what common errors mean, and where the logs are.
העמוד הזה עדיין לא תורגם, ולכן הוא מוצג באנגלית. אפשר לתרגם אותו ב־GitHub. GitHub ↗
Check the setup
letronna doctorIt checks the version, your system, the data folder and the space left on its disk, the settings, where your keys are kept, the logs, the last crash, and whether the gateway answers. It ends with "No problems found." or says what is wrong. To check without using the network:
letronna doctor --offlineWhen a message fails
A failed request says why in the chat, and in the window offers the fix. The usual reasons:
| It says | What to do |
|---|---|
| the key was refused | check the key under Settings > Accounts, or with /connect |
| out of credit | add credit on Billing, switch to a gateway with your own key, or set a fallback model |
| a rate limit | wait the time it names; Letronna waits out short limits by itself |
| the provider is busy | try again, or pick another model |
| the conversation is too long | /compact summarises earlier turns; /new starts fresh |
/fallback names models to carry on with when yours is overloaded or out of credit:
/fallbackSigning in
- If the browser does not open, the app offers to open the page again or copy its link.
/whoamishows who is signed in on this computer;/loginsigns in again.- Devices lists the computers signed in to your account.
A model on your own server answers badly
If Letronna does not know a model's limits, set them in the environment:
LETRONNA_CONTEXT_WINDOW=32000 LETRONNA_MAX_OUTPUT=4096 letronnacontext_window and max_output in settings.json do the same for good.
Logs and crashes
Letronna keeps a log in logs/ and crash reports in crashes/, in your data folder. They stay on your computer. letronna doctor shows where they are and the last crash.
Starting over
Run setup again to change your name, gateway, model or what is installed:
letronna setupUninstalling keeps your data folder, so your sessions and memory stay.
Still stuck
Write to support@letronna.ai with what you did, what it said, and the output of letronna doctor.