Errores comunes

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

Errores de Ollama

Connection refused al puerto 11434

Error: Connection refused http://localhost:11434

Causa: Ollama no esta corriendo.

Solucion:

ollama serve        # Inicia el servidor en primer plano
# o como servicio de sistema:
brew services start ollama  # macOS con Homebrew

HTTP 500 en tool calls con qwen3.5

Error: HTTP 500 Internal Server Error al llamar herramienta

Causa: Bug conocido de Ollama con modelos qwen3.5:* (marzo 2026). Ver #14493.

Solucion: Usa modelos Qwen3 sin el .5:

ollama pull qwen3:14b
# Y en .env:
OLLAMA_MODEL=qwen3:14b

Modelo no encontrado

Error: model 'qwen3:14b' not found

Solucion:

ollama pull qwen3:14b
ollama list  # Verifica que esta descargado

Errores de API Keys

API key no configurada

VirusTotal: VIRUSTOTAL_API_KEY no configurada. La herramienta devolvera resultados vacios.

Solucion: Edita .env y añade la key. Verifica que el fichero .env existe y no esta vacio:

cat .env | grep VIRUSTOTAL

API key invalida o expirada

Error: 403 Forbidden — Invalid API key

Solucion: Regenera la key en el panel del servicio correspondiente y actualiza .env.

Rate limit excedido

Error: 429 Too Many Requests

Solucion:

Aumenta BATCH_DELAY_SECONDS en .env
Espera al reset de quota (generalmente diario)
El cache previene re-llamadas: si ya analizaste el IOC hoy, no consume quota

Errores de investigacion

No hay investigacion activa

Error: No hay investigacion activa. Usa /investigation-init primero.

Solucion:

osint-agent investigation list
osint-agent investigation use <slug>
# o:
/investigation-init "Mi Investigacion"

Investigacion activa no encontrada

Error: Investigacion 'caso-acme' no existe en la base de datos

Solucion: El fichero data/.active apunta a un slug que no existe. Usa osint-agent investigation list y activa una valida.

Error de ChromaDB al ingestar

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

Solucion: La coleccion ChromaDB puede estar corrupta. Borra el directorio y recrea la investigacion:

rm -rf data/chroma/osint_caso-acme
/investigation-init "Caso Acme" --goal "..."

Errores de Docker

Ollama no accesible desde el contenedor

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

Causa: Dentro de Docker, localhost es el contenedor, no el host.

Solucion:

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

Errores de instalacion

pip install falla con errores de compilacion

error: legacy-install-failure — httpx

Solucion:

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

mypy falla con errores de tipo

Solucion: Normalmente son falsos positivos en dependencias externas. Verifica que solo hay errores en codigo que cambiaste:

mypy src/ --ignore-missing-imports