Troubleshooting

Most problems come down to a missing key or an unreadable file. This page lists the errors you are most likely to hit and what to do about each one.

No AI API Key Configured

No AI API key configured. Add one in Settings.

The assistant has no provider key to work with. Open Settings → AI Models and add a key for any supported provider.

Tavily API Key Is Missing

Tavily API key is missing. Set it in Settings or VITE_TAVILY_API_KEY.

This appears only when the assistant tries to run a web search and no Tavily key is set. Add one under Settings → Tavily web search, or set VITE_TAVILY_API_KEY for local development. Web search is optional — you can ignore this and rely on your own sources and PubMed.

Empty or Failed Responses

A request that returns nothing usually means the provider key is missing, invalid, or out of quota. Check the key in Settings first. If the key is valid, the provider itself may be rate limiting or temporarily unavailable, in which case waiting and retrying is the fix.

PDF Text Extraction Failed

[PDF uploaded - automatic text extraction failed. Convert to text before ingesting.]

PDFs are parsed in the browser, but scanned PDFs, or PDFs that contain only images, have no selectable text to extract. The source is still stored, but it will not enter retrieval. Convert the document to text, or paste the relevant passages in as a text source instead.

A Revision Skipped Part of Your Request

On a note with a locked template, suggested changes that conflict with a locked section anchor are dropped. Unlock the template or rephrase the request to target an editable section.

Settings or Tasks Are Not Syncing

Sync requires an account. Signed out, your workspace lives only in the browser’s local storage on the current machine, and scheduled tasks will not run in the background.

The App Will Not Start Locally

Install dependencies and start the dev server from the project folder:

cd rosetta
npm install
npm run dev

The dev server expects its port to be free. If another process is using it, stop that process or start the dev server on a different port.