Troubleshooting Guide
This document provides structured solutions for common issues encountered when using Ollama Toolkit v0.1.9, organized by problem domain with Eidosian precision and recursion.
Connection Issues
Symptoms
ConnectionError
exceptions“Failed to connect” messages
Timeout errors on initial connection
Potential Causes & Solutions
1. Ollama Server Not Running
Diagnostic:
from ollama_toolkit.utils.common import check_ollama_running
is_running, message = check_ollama_running()
print(f"Ollama running: {is_running}, Message: {message}")
Solution: Start the Ollama server with one of these approaches:
# Method 1: Using toolkit utilities
from ollama_toolkit.utils.common import ensure_ollama_running
ensure_ollama_running()
# Method 2: Command line (execute in terminal)
ollama serve
Model Loading Errors
When models fail to load…
Performance Problems
If generation is too slow…