Documentation

Troubleshooting Guide

Common issues and solutions. If you can't find your problem here, contact support for help.

Quick Fixes to Try First

Restart Everything

Often the simplest solution: Restart Typilot, Ollama, and if needed, your computer.

Check Connections

Verify Ollama is running and Typilot can connect to it at http://localhost:11434

Review Settings

Double-check your settings: default model, Ollama URL, keyboard shortcuts, and paths.

Check Logs

Look at the Logs page in Typilot for error messages that might indicate the problem.

Installation

Typilot won't start after installation

  • Check if your system meets minimum requirements (4GB RAM, 2GB disk space)
  • Try running as administrator (Windows) or with sudo (Linux)
  • Check for error messages in system logs
  • Reinstall Typilot if issues persist

Ollama installation fails

  • Check your internet connection during download
  • Ensure you have administrator/root privileges
  • Try downloading directly from ollama.com
  • On Linux, ensure curl is installed: sudo apt-get install curl

Connection

Typilot can't connect to Ollama

  • Verify Ollama is running: Visit http://localhost:11434 in your browser
  • Check the Ollama URL in Settings matches http://localhost:11434
  • Try restarting both Ollama and Typilot
  • On Windows, check if Windows Firewall is blocking Ollama
  • On Linux, ensure Ollama service is running: sudo systemctl status ollama

Models not showing up

  • Ensure Ollama is running and connected
  • Try refreshing the Models page
  • Restart Typilot
  • Check if models are actually downloaded in Ollama: Run `ollama list` in terminal

Performance

AI responses are very slow

  • Try a smaller model (like llama3.2:1b or llama3.2:3b)
  • Close other applications to free up RAM
  • Check if you have enough RAM (8GB+ recommended for 3b models)
  • Adjust response speed in Settings (lower = faster, but less natural)
  • Consider using a model that matches your hardware

Application freezes when using AI

  • Use a smaller model
  • Ensure you have sufficient RAM (close other apps)
  • Check system resource usage (Task Manager/Activity Monitor)
  • Restart Typilot

Keyboard Shortcuts

Keyboard shortcut doesn't work

  • Check if the shortcut conflicts with system shortcuts (like Spotlight on macOS)
  • Try changing the shortcut in Settings to avoid conflicts
  • Ensure Typilot has necessary permissions (accessibility permissions on macOS)
  • On Linux, you may need to run Typilot with proper permissions
  • Restart Typilot after changing shortcuts

Shortcut works but command doesn't execute

  • Verify Ollama is running and connected
  • Ensure a model is selected in Settings
  • Check that you're using the correct send key (default: period)
  • Look for error messages in the Logs page

Image Analysis (img:)

img: command doesn't work

  • Ensure you have a vision-capable model (llama3.2-vision:11b) downloaded
  • Verify Tesseract OCR is installed: Run `tesseract --version` in terminal
  • Check Tesseract path in Settings (if configurable)
  • Restart Typilot after installing Tesseract
  • Try capturing a clear, well-lit screenshot

Text extraction fails or is inaccurate

  • Ensure screenshot is clear and text is readable
  • Try capturing a larger region or full screen
  • Check Tesseract installation is correct
  • Some fonts/styles may be harder for OCR to read

Still Need Help?

If none of these solutions work, here are additional resources:

  • Check the Getting Started guide for setup issues
  • Review the Ollama setup guide for connection problems
  • Check Typilot's Logs page for detailed error messages
  • Contact support with your system information and error details

System Information to Include

When contacting support, include:

  • Your operating system and version
  • Typilot version
  • Ollama version (run: ollama --version)
  • RAM and CPU information
  • Error messages from the Logs page
  • Steps you've already tried