Troubleshooting

Last updated 2026-03-11

Voice mode not working

If voice mode doesn't start or the assistant can't hear you:

  1. Check microphone permissions. Click the lock icon in your browser's address bar and ensure microphone access is set to "Allow" for theostack.com.
  2. Try a different browser. Voice mode works best in Chrome, Edge, and Safari. Firefox support may be limited.
  3. Check your microphone. Make sure your microphone is not muted at the system level and is selected as the default input device.
  4. Reduce background noise. The voice activity detection works best in a reasonably quiet environment.

Slow responses

If responses are taking longer than expected:

  • Complex questions that search across many library documents naturally take longer. Try being more specific.
  • Large file uploads may take time to process before they're available for search.
  • Network connection — Theostack requires an active internet connection. Check your connectivity.
  • Peak usage — During high-traffic periods, responses may be slightly slower.

Source cards not appearing

Source cards should appear alongside every library-grounded response. If they're missing:

  • The assistant may not have found relevant library content for your specific question. Try rephrasing.
  • Some questions (like general conversation or questions about Theostack itself) don't require library search and won't produce source cards.

Clearing browser cache

If the app behaves unexpectedly, clearing your browser cache can help:

  1. Open your browser settings.
  2. Navigate to Privacy/History and select "Clear browsing data."
  3. Select "Cached images and files" (you don't need to clear cookies or passwords).
  4. Reload theostack.com.

Supported browsers

Theostack works in all modern browsers:

  • Chrome (recommended) — Full support including voice mode
  • Edge — Full support including voice mode
  • Safari — Full support including voice mode
  • Firefox — Text features fully supported; voice mode may have limitations

We recommend keeping your browser up to date for the best experience.

Reporting a bug or giving feedback

If you encounter an issue not covered here:

  • Email: hello@theostack.com — We read every message and typically respond within one business day.
  • In-app feedback: Use the feedback button (available on authenticated pages) to report issues directly. Feedback is routed to our development team.

When reporting a bug, include:

  • What you were trying to do
  • What happened instead
  • Your browser and device (e.g., Chrome on Mac, Safari on iPhone)
← Privacy & Data