Troubleshooting

Zymorph asks me to connect a model

Open Settings → Model providers and either sign in with a supported subscription or add your own provider API key.

If a provider appears connected but no models show, reopen the picker and clear any search/provider filter. If it remains empty, sign out under Model providers, sign in again, and retry.

A request says I have no credits or quota

This comes from the selected model provider.

1. Check the model name in the composer.
2. Open the provider’s account and review credit, billing, and usage limits.
3. Add credit, raise the limit, or choose another connected model.
4. Select Try again only after fixing the provider issue.

Zymorph cannot change third-party billing. With BYOK, charges go to the account that issued the key.

The app is paused or could not start

• Select Start app when the preview says it is paused.
• Select Try again when the preview says it could not start.
• Open Settings → App controls and select Restart if the message returns.

If the status remains Crashed, export support information and reopen Zymorph.

Zymorph is stuck on Starting or Updating

Wait a few minutes for a large change. If there is no progress:

1. select Stop if a request is still running;
2. open App controls and select Restart;
3. try the app before resending the request;
4. resend a smaller, focused change.

Stopping does not guarantee that already completed edits are undone.

A connected feature says access is unavailable

Open Settings → Connections.

• Add or choose the required account.
• Select Reconnect if the session expired.
• Review the listed operations if connection details changed.
• Confirm that the app—not only the device account—has a grant.

For Google Drive browser sign-in, return to Connections and use Add account or Reconnect.

The app cannot read or save a local file

Open Settings → App controls and check Folder access.

• The folder must be explicitly listed.
• Read-only access cannot save changes.
• If the folder moved, remove and add it again.
• Restart the app after changing a grant if the app does not recognize it.

A private key is missing

Open Settings → Connections and look for Keys requested by this app. Enter the key there. Do not paste it into the conversation.

A model-provider key belongs in Model providers, not this section.

A change made the app worse

Try these in order:

1. describe the observed problem and ask Zymorph to correct it;
2. restore the previous design if the problem began with a design change;
3. restore a source version if only source should move back; or
4. restore a Recovery point if source and durable app data must return together.

Read Recovery and source versions before restoring.

Recovery is paused

Check the message under Automatic Recovery.

• Free device space if host space is low.
• Increase the Recovery storage limit if the configured limit is full.
• Reopen Zymorph if Recovery is unavailable rather than merely paused.

Export support information

Go to Settings → App controls → Support information and select Export…. Save the file somewhere you can find, then send it to Zymorph support only when requested.

If you want to remove stored support history afterward, select Clear. This does not clear conversations, app data, or Recovery points.

Still blocked

Write down:

• the visible error message;
• the action immediately before it;
• the current app status;
• the selected model/provider when relevant;
• whether Restart changed the result.

Contact hello@zymorph.app and include the exported support file only if requested.