Troubleshoot guide

Ceres troubleshoot guide

Troubleshooting guide for Ceres Assistant and IDE extensions.

Ceres Assistant

Get Ceres Assistant from the Chrome Web Store

Why do the inline buttons take a long time to load?

If you have not added an API key, some actions may try to use the browser's built-in AI. That can be slow depending on your computer, browser, memory, CPU, GPU, and driver support. This kind of local browser AI is still experimental, so the first request can feel heavy on older hardware.

For faster and higher quality results, add an API key from OpenAI, Google AI Studio, DeepSeek, OpenRouter, or another supported provider in the sidebar settings. Ceres rewrites, speech transcription, and browser assist become much faster and more reliable with a good provider key.

Why does smart buttons stay on connecting or processing?

Chrome extensions run under Manifest V3, and Chrome may suspend extension workers to save resources. If the extension says connecting or processing for a long time, it may be waking up before it can handle the request.

Give it a moment, especially after the browser has been idle. After the worker wakes up, the next requests are usually faster. If the same problem continues, send us a bug report with your browser, extension name, model provider, and what you were trying to do.

How should I set up my API key?

If you use OpenAI, GPT-5 mini is a good everyday choice for writing and assistant work. For Speech to Text in the browser, choose a speech model such as GPT Audio when it is available in your provider settings.

If you use Google AI Studio, Gemini 3 Flash is usually enough for inline proofread, short rewrites, transcription cleanup, and normal browser tasks. Gemini 3 Pro can be useful for heavier Ceres work, but it is often overkill for simple proofreading or short replies.

For lower cost, try DeepSeek, OpenRouter, or another OpenAI-compatible provider. Some providers include free usage, budget models, or very low pricing. If you want the tool to feel instant, choose a fast model before choosing the biggest model.

Why does Navigation mode show “unsupported tools” errors?

If Navigation mode does not work, or you see tool-related or “not supported” errors, the selected AI model may not support tool calling. You can disable Navigation mode and continue using regular chat, or switch to an LLM that supports tool calling.

Why isn't Reasoning mode working?

If Reasoning mode does not work even though it is enabled, the selected AI model may not support reasoning. You can disable Reasoning mode and continue using regular chat, or switch to an LLM that supports reasoning.

What is the context window bar?

After you add a key, you may see a bar or window at the top that slowly fills up. This is the context window. It shows how full the conversation is getting as you add text, files, URLs, PDFs, images, or long replies.

If the context window becomes too full, the model may stop seeing the whole conversation clearly. Use the arrows and Break Window to split the conversation at the point you choose. After that, the model focuses on the lower, useful part of the chat. This lets you keep working without deleting the whole conversation or paying for very large context models every time.

Why can some large PDFs or URLs not be read?

Ceres includes read limits to prevent accidentally sending very large PDFs or URLs and creating expensive API calls. If a PDF or URL is too large, the extension may stop before reading all of it.

Open settings and increase the Read URL / Read File limit if you know the content is safe to process. Use a larger limit only when you understand the possible token cost.

Why do I need my own provider key?

Most AI extensions do not own the large AI models they use. They call providers such as OpenAI, Google, Anthropic, DeepSeek, or other model platforms, then include that cost inside a subscription.

We chose a different approach. You bring the provider you want, use the model you prefer, and pay the provider directly for the usage you create. This avoids hiding model costs inside our pricing and lets you use free provider allowance, local models, or budget APIs when they fit your work.

How much will API usage cost?

It depends on the model and the product. Ceres usually makes many small calls for proofreading, rewriting, transcription, or short browser text actions. It does not send an entire long session for a simple correction. With a mini or budget model, the monthly cost can be tiny, sometimes under one euro for light use, or free when your provider includes free allowance.

Ceres can cost more because it may analyze longer conversations, files, URLs, PDFs, code, or project context. Even then, it can still be much cheaper than long autonomous coding sessions that call the model repeatedly while exploring the project.

A practical starting point is to add five or ten euros of credit to your favorite provider and watch usage for a few days. If you choose Gemini Flash, DeepSeek, or another budget model, normal use may feel almost invisible in cost.

Why is Speech to Text giving the wrong text?

In the browser, Speech to Text works with the browser speech-to-text engine unless the user has configured an audio LLM in settings. The browser handles language detection automatically.

Browser speech to text

If the result is completely unrelated, or you receive recording errors, start with the microphone. Check browser permission, selected input device, microphone volume, and the physical connection. Test with a simple audio recorder until the recording sounds clean.

Why do I see "Built-in AI is not available on your computer"?

Browser built-in AI is available only in the Ceres browser extension and only for its floating Writing buttons when no AI provider is set in settings. These actions run locally through your browser.

Your computer must support Chrome built-in AI. Chrome docs list two supported paths: a suitable GPU, or a CPU setup with at least 16 GB of RAM and 4 CPU cores. The first run may also need time to download the local model. Source: Chrome built-in AI requirements.

If your browser cannot run built-in AI on your computer, add an AI provider in settings. After that, Ceres will use your selected provider for these AI features.

Which features use browser built-in AI?

Browser built-in AI is used only by the floating Writing buttons in the Ceres browser extension: Grammar, Summary, Collapse Text, Expand Text, and custom writing prompts. It is not available in the IDE or for other Ceres features.

Sidebar chat, Live Assistant, Command Assistant, Speech to Text, OCR, and image features do not use browser built-in AI. They need an AI provider when the feature requires one.

What engine powers browser built-in AI?

Ceres uses the browser's built-in Prompt API when it is available. In Google Chrome, this API runs on Gemini Nano. In Microsoft Edge, Microsoft uses Phi-4-mini instead. Sources: Chrome Prompt API and Microsoft Edge Prompt API.

The browser provides the model and decides if your computer can run it.

Ceres in Visual Studio Code

Ceres works with local AI through Ollama and LM Studio, as well as OpenAI-compatible APIs. It is designed for focused coding help: selected files, controlled edits, and debugger context, rather than long autonomous agentic sessions running in the background.

Choose a reliable coding model from OpenAI, Anthropic, Google, DeepSeek, or another provider you trust. For local control, test Ollama or LM Studio with a coding model that fits your machine.

Set up Ceres in VS Code

Enable Editor: Inlay Hints in VS Code settings to show the inline Add to Ceres actions near functions and selections. Search for inlay hints in Settings and set it to enabled or on unless pressed.

Why is drag and drop not working in Visual Studio Code?

When dragging an editor tab into Ceres IDE Chat, hold Shift. Visual Studio Code can otherwise block the normal drop behavior.

VS Code and IDE speech to text

Inside the IDE, Speech to Text can fall back to your operating system speech recognizer when the remote audio API is not available. This is useful, but it depends on the speech packages installed on your computer.

If you see poorly transcribed on VS Code, configure audio model at API settings, the local OS recognizer probably heard something but produced low-quality text. If the output is in the wrong language, install the correct speech recognition package in your operating-system language and speech settings, then restart the IDE.

On Linux, the local OS speech fallback is unavailable; configure an audio model in app settings instead. If transcription quality is still not good enough, connect your own audio LLM in the application settings.

Login 🔓
login