Variables de entorno

LLM

Variable	Tipo	Default	Descripcion
`LLM_PROVIDER`	string	`ollama`	`ollama` \| `openai` \| `anthropic`
`OLLAMA_MODEL`	string	`qwen3:14b`	Modelo Ollama con soporte de tool calling
`OLLAMA_BASE_URL`	string	`http://localhost:11434`	URL del servidor Ollama
`OPENAI_MODEL`	string	`gpt-4o`	Modelo de OpenAI
`OPENAI_API_KEY`	string	—	API key de OpenAI
`ANTHROPIC_MODEL`	string	`claude-3-5-sonnet-20241022`	Modelo de Anthropic
`ANTHROPIC_API_KEY`	string	—	API key de Anthropic

API Keys OSINT

Variable	Servicio	Free tier
`VIRUSTOTAL_API_KEY`	VirusTotal	500 req/dia
`ABUSEIPDB_API_KEY`	AbuseIPDB	1.000 req/dia
`ALIENVAULT_OTX_API_KEY`	AlienVault OTX	Ilimitado
`SHODAN_API_KEY`	Shodan	100 req/mes
`IPINFO_TOKEN`	IPInfo	50.000 req/mes
`URLSCAN_API_KEY`	URLScan.io	5.000 req/dia
`FRED_API_KEY`	FRED	Gratuito
`EIA_API_KEY`	EIA	Gratuito
`CLOUDFLARE_API_TOKEN`	Cloudflare Radar	Gratuito
`ACLED_ACCESS_TOKEN`	ACLED	Gratuito (investigacion)
`ACLED_EMAIL`	ACLED	Requerido con el token
`AISSTREAM_API_KEY`	AISStream	Gratuito

Comportamiento OSINT

Variable	Tipo	Default	Descripcion
`CACHE_TTL_SECONDS`	int	`86400`	TTL del cache de resultados (segundos)
`MAX_PIVOTS`	int	`2`	Profundidad maxima de auto-pivot
`THREAT_FEED_LIMIT`	int	`10`	Max IOCs por fetch de feed
`BATCH_DELAY_SECONDS`	float	`2`	Pausa entre IOCs en batch

Rutas de datos

Variable	Tipo	Default	Descripcion
`OSINT_CACHE_DB_PATH`	path	`data/osint_cache.db`	SQLite de cache OSINT
`INVESTIGATION_DB_PATH`	path	`data/osint_ai.db`	SQLite de investigaciones
`CHROMA_PATH`	path	`data/chroma`	Directorio ChromaDB
`INVESTIGATIONS_DIR`	path	`investigaciones`	Directorio raiz de investigaciones

Embeddings

Variable	Tipo	Default	Descripcion
`EMBEDDING_MODEL`	string	`sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2`	Modelo de embeddings para ChromaDB

Cuotas

Variable	Tipo	Default	Descripcion
`ACTIVE_INVESTIGATIONS_LIMIT`	int	`5`	Max investigaciones activas simultaneas
`MONTHLY_OPERATIONS_LIMIT`	int	`100`	Cuota mensual de operaciones

Servidores

Variable	Tipo	Default	Descripcion
`MCP_TRANSPORT`	string	`stdio`	`stdio` \| `streamable-http`
`MCP_HTTP_PORT`	int	`8080`	Puerto HTTP para MCP
`A2A_HOST`	string	`0.0.0.0`	Interfaz de escucha A2A
`A2A_PORT`	int	`9000`	Puerto del servidor A2A

Lectura de variables en el codigo

El sistema usa Pydantic Settings (src/config.py). Las variables se leen en el arranque y se validan con tipos. Si una variable obligatoria falta, el arranque falla con un mensaje claro.

from src.config import settings

# Acceso a las variables
print(settings.virustotal_api_key)
print(settings.cache_ttl_seconds)
print(settings.ollama_model)