llm-aggregator 0.1.4

A model aggregator service for multiple LLM backends.

LLM Aggregator

LLM Aggregator keeps a live list of every model exposed by your local OpenAI-compatible servers.

Web Interface

The UI is a single table plus a small RAM widget, so you immediately see what is running:

Model	Base URL	Types	Family	Context	Quant	Params	Summary
llama3.1:8b	http://10.7.2.100:11434/v1	llm	Llama 3.1	8K	Q4_K_M	8B	General chat tuned for balance
qwen2.5:14b	http://10.7.2.100:8080/v1	llm,embed	Qwen 2.5	32K	Q5_0	14B	Multilingual reasoning focused

Columns:

• Model – identifier reported by the provider.
• Base URL – where the model is served.
• Types – capabilities (LLM, VLM, embedder, etc.).
• Family – base architecture inferred by the helper LLM.
• Context – approximate context window in tokens.
• Quant – quantization hinted by the model name or docs.
• Params – estimated parameter count.
• Summary – one-line description generated by the helper LLM.

Features

• Multi-Provider Discovery: Automatically discovers models from multiple LLM servers running on different ports
• AI-Powered Enrichment: Uses a configurable "brain" LLM to enrich model metadata with details like model family, context size, quantization, and capabilities
• Web Catalog Interface: Clean web UI for browsing your model collection
• Real-time Statistics: Monitors system resources like RAM usage
• REST API: Programmatic access to model data and statistics
• Background Processing: Continuous model discovery and enrichment without blocking the UI
• OpenAI-Compatible: Works with any LLM server that implements the OpenAI /v1/models API

Installation

Prerequisites

• Python 3.10 or higher
• One or more running LLM servers (Ollama, llama.cpp, nexa, etc.) with OpenAI-compatible APIs

Install from PyPI

pip install llm-aggregator

Configuration

All runtime behavior is controlled through the YAML file pointed to by the LLM_AGGREGATOR_CONFIG environment variable. Use config.yaml as a reference template.

Configuration Options

• host / port – Where the FastAPI server and static frontend bind.
• log_level – Logging verbosity (DEBUG, INFO, WARNING, ERROR, CRITICAL). Defaults to INFO if omitted.
• log_format – Optional logging format string. When omitted the service leaves existing logging configuration untouched.
• logger_overrides – Map of logger names to override their logging level (e.g., httpx: WARNING).
• brain – Settings for the enrichment LLM:
  • base_url – HTTP endpoint of the enrichment provider.
  • id – Model identifier passed to the provider.
  • api_key – Optional API-Key.
  • max_batch_size – Number of models to enrich at once (defaults to 1).
• time – Background scheduling knobs (all in seconds):
  • fetch_models_interval
  • fetch_models_timeout
  • enrich_models_timeout
  • enrich_idle_sleep
• providers – Each entry describes an OpenAI-compatible backend to query:
  • base_url – Public URL returned via the REST API.
  • internal_base_url – Optional internal URL used for server-to-server calls; defaults to base_url when omitted.
  • api_key – Optional API-Key for that provider.
• model_info_sources – Optional external websites where model information is fetched from for enrichment. Each entry requires a human-readable name (shown to the LLM) and a url_template that contains {model_id}.
• ui – Optional static UI:
  • static_enabled – When true then a web frontend is served at /index.html and assets at /static.
  • custom_static_path – Optional directory that replaces the bundled UI; must contain a readable index.html and asset files.

Usage

Set the LLM_AGGREGATOR_CONFIG environment variable to point at your config.yaml and the service will load it on startup.

Starting the Service

export LLM_AGGREGATOR_CONFIG=/path/to/config.yaml
llm-aggregator

Or run directly:

export LLM_AGGREGATOR_CONFIG=/path/to/config.yaml
python -m llm_aggregator

By default, the web interface will be available at http://localhost:8888.