List open-weights LLMs from quelllm.fr catalog (190+ models).

Args: filter_origin: filter by author origin code, e.g. 'fr', 'us', 'cn' filter_family: filter by model family, e.g. 'Mistral', 'Qwen', 'Llama' max_params_b: maximum number of params in billions (e.g. 32 for ≤32B models)

Returns: dict with keys: count, models (list of {id, name, author, params, family, license, vram_q4_gb})

Get full details for a single model.

Args: model_id: the model ID (e.g. 'mistral-7b-instruct', 'qwen3-8b')

Returns: full model record with params, vram per quant, context window, family, tags, license, and URLs.

Compare two LLMs side-by-side.

Args: model_a_id: first model ID model_b_id: second model ID

Returns: comparison dict with VRAM, params, license, context window, family, origin for both models, plus a verdict

Estimate VRAM required to run a model at a given quantization.

Args: model_id: the model ID quant: quantization level — one of 'q4', 'q5', 'q8', 'fp16'. Default 'q4'.

Returns: dict with vram_gb (estimate including context overhead) + recommended GPU tiers

Estimate monthly cost for LLM usage — API providers OR self-hosted hardware.

Args: input_tokens_per_month: total input tokens per month output_tokens_per_month: total output tokens per month model_or_hardware: specific model/hw ID (e.g. 'gpt-5', 'rtx-5090'). If None, returns full comparison table. amort_months: amortization period for hardware purchase, default 24 months electricity_eur_per_kwh: electricity rate, default 0.20 EUR/kWh (FR 2026 average) hours_active_per_day: hours of active inference per day, default 4 caching_hit_rate: 0..0.9 fraction of input tokens hitting prompt cache (Anthropic 90% off / Gemini 75% off). Default 0. batch_mode: True applies 50% off input+output for batchable APIs (24h delay). Default False. off_peak: True applies DeepSeek off-peak discount (50% V3.5 / 75% R1). Default False. pc_always_on: True = idle (24-hours_active) × idleW. False = PC off out of active hours (0W idle). Default True. vat_recoverable: True = subtract 16.67% VAT from hardware purchase price (HT pour pro). Default False.

Returns: cost estimate in EUR (with USD-to-EUR conversion ~0.92 for APIs)

Fuzzy search models by name, family, tag, or author.

Args: query: search string limit: max number of results, default 10

Returns: dict with count and matching models (sorted by relevance)