Common Errors

import { Aside } from ‘@astrojs/starlight/components’;

Ollama Errors

Connection refused on port 11434

Error: Connection refused http://localhost:11434

Cause: Ollama is not running.

Solution:

ollama serve        # Start server in foreground
# or as system service:
brew services start ollama  # macOS with Homebrew

HTTP 500 on tool calls with qwen3.5

Error: HTTP 500 Internal Server Error when calling tool

Cause: Known Ollama bug with qwen3.5:* models (March 2026). See #14493.

Solution: Use Qwen3 models without the .5:

ollama pull qwen3:14b
# And in .env:
OLLAMA_MODEL=qwen3:14b

Model not found

Error: model 'qwen3:14b' not found

Solution:

ollama pull qwen3:14b
ollama list  # Verify it's downloaded

API Key Errors

API key not configured

VirusTotal: VIRUSTOTAL_API_KEY not configured. Tool will return empty results.

Solution: Edit .env and add the key. Verify the .env file exists and is not empty:

cat .env | grep VIRUSTOTAL

Invalid or expired API key

Error: 403 Forbidden — Invalid API key

Solution: Regenerate the key in the respective service panel and update .env.

Rate limit exceeded

Error: 429 Too Many Requests

Solution:

Increase BATCH_DELAY_SECONDS in .env
Wait for quota reset (usually daily)
Cache prevents re-calls: if you already analyzed the IOC today, it doesn’t consume quota

Investigation Errors

No active investigation

Error: No active investigation. Use /investigation-init first.

Solution:

osint-agent investigation list
osint-agent investigation use <slug>
# or:
/investigation-init "My Investigation"

Active investigation not found

Error: Investigation 'acme-case' not found in database

Solution: The data/.active file points to a slug that doesn’t exist. Use osint-agent investigation list and activate a valid one.

ChromaDB error on ingest

Error: ChromaDB collection not found for slug 'acme-case'

Solution: ChromaDB collection might be corrupted. Delete the directory and recreate the investigation:

rm -rf data/chroma/osint_acme-case
/investigation-init "Acme Case" --goal "..."

Docker Errors

Ollama not accessible from container

Error: Could not connect to Ollama at http://localhost:11434

Cause: Inside Docker, localhost is the container, not the host.

Solution:

# In .env for Docker:
OLLAMA_BASE_URL=http://host.docker.internal:11434  # macOS/Windows
OLLAMA_BASE_URL=http://172.17.0.1:11434            # Linux (bridge IP)

Installation Errors

pip install fails with compilation errors

error: legacy-install-failure — httpx

Solution:

pip install --upgrade pip
pip install -e ".[dev]"

mypy fails with type errors

Solution: Usually false positives in external dependencies. Check that only code you changed has errors:

mypy src/ --ignore-missing-imports