Troubleshooting Guide — Ollama Toolkit 0.1.9 documentation

# 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…