Troubleshooting

Launch

What you see What to do
PowerShell does not run start.ps1 Use the direct launch command from Installation.
The port is busy Start with another port, for example -Port 8770.
"This data directory is already open by another worker" Another server is already using this directory. Close its PowerShell window or choose another data directory.
The page behaves oddly after an update Save your edits, restart the server and reload the tab.

Generation does not start

What you see What to do
Asks you to set an age rating Set the rating in the story settings, Writing section. See Age rating.
Blocked because of character age Add Age: to the card, remove the character from the scene cast, or change the scene rating. See Character age.
"Set an explicit story budget limit first" Set the total limit in Call budget. See Call budget.
"No valid pricing" Press Update from catalog or save manual pricing.
"Insufficient … budget" Raise the total or the per-run limit. The reserve is conservative and counts the full response.
Key or authentication error Check the key in .env and restart the server.
The request does not fit the context Shorten the materials, lower the response reserve or choose a model with a larger real context. Text is never silently cut.

While working

What you see What to do
The model refused There is no automatic retry. Change the brief or the model and run the stage again.
A run was interrupted by a failure or a server shutdown An unfinished run becomes interrupted. Continue it explicitly; repeating a cloud call may cost money.
A material is marked outdated Its sources changed. Regenerate it, or in the version history press Review and accept text and then Continue after accepted stage.
"Changed in another tab" Your edits stay in the form. Refresh the data and repeat the action.
A cost "needs reconciliation" After a failure the cost is unknown. Reconcile the amount in Call history and reconciliation once the run is over.

Export

What you see What to do
FB2 asks for an author or a genre Fill them in on the publication card and press Save card.
The publication extras are required Install them with the command from Installation.
Export asks for permission Some scenes need review or have no prose. Allow an incomplete export or finish the scenes first.

Backups

Before an update or an experiment, make a backup as described in Backup. A restore creates a new directory and overwrites nothing. If a backup or restore was interrupted, do not use the incomplete directory: repeat the action from a verified copy into a new directory.