Troubleshooting

Most problems come down to a missing key, an excluded source, or a file Rosetta could not read. 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 Google, OpenAI, Anthropic, DeepSeek, or OpenRouter. A Google Gemini key is the simplest starting point and covers both the default model and retrieval.

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, so you can also 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.

Answers Ignore Your Sources

If the assistant answers without using material you added, the source is almost always empty or excluded. Open the RAG panel and confirm two things:

1. The source has content.
2. Its “included in ingest” toggle is on.

Only included sources with usable text are searched.

PDF Text Extraction Failed

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

Rosetta parses PDFs in the browser, but scanned or image-only PDFs 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. This protects required headings, disclaimers, and billing fields. Unlock the template or rephrase the request so it applies to 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. Sign in if you want settings and tasks to persist across browsers and sessions.

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 Rosetta on a different port.