llm_router_web#

llm_router_web is the web interface component of the **llm-router ** project.
It provides a Flask‑based UI for managing LLM model configurations, users, and version history.

Table of Contents#

• Features
• Installation
• Running the Application
• Configuration
• Endpoints Overview
• Development
• License

Features#

• User Management – Admins can create, edit, block/unblock users and assign roles (admin / user).
• Configuration CRUD – Create, import, edit, view, export, activate and delete model configurations.
• Model & Provider Management – Add/remove models, manage multiple providers per model, reorder providers via drag‑and‑drop.
• Versioning – Automatic snapshot of each change; view history and restore previous versions.
• Theme Switching – Light / dark UI themes toggled client‑side.
• Responsive UI – Built with HTML, CSS, HTMX and Alpine.js for a smooth, single‑page‑like experience.

Installation#

The project uses Python 3.10.6 and virtualenv.

```shell script

Clone the repository#

git clone https://github.com/radlab-dev-group/llm-router.git cd llm-router/llm_router_web

Create and activate a virtual environment#

python3 -m venv venv source venv/bin/activate

Install dependencies#

pip install -r requirements.txt

> **Note:** The only required packages are listed in `requirements.txt` (`flask` and `flask_sqlalchemy`). All other
> libraries are part of the broader `llm-router` repository.

---

## Running the Application

```shell script
# Start the Flask development server
python app.py

The UI will be available at http://localhost:8081.
The first run will redirect you to a setup page where you must create an initial admin user.

Environment variables#

Configuration#

All Flask configuration is performed in web/__init__.py via create_app().
Key settings:

• SQLALCHEMY_DATABASE_URI – points to the SQLite DB (configs.db) unless overridden.
• SQLALCHEMY_TRACK_MODIFICATIONS – disabled for performance.
• PREFERRED_URL_SCHEME – set to https when FLASK_ENV=production.

The database schema is automatically created on first launch. If the order column is missing from the provider table (e.g., after a schema change), the helper _ensure_provider_order_column() adds it on startup.

Endpoints Overview#

All routes are protected by session‑based authentication. Admin‑only routes require the admin role.

Development#

Code structure#

llm_router_web/
├─ web/
│  ├─ static/        # CSS files (dark/light themes)
│  ├─ templates/    # Jinja2 HTML templates
│  ├─ __init__.py   # Flask app factory
│  ├─ constants.py
│  ├─ models.py     # SQLAlchemy models
│  ├─ routes.py     # All view functions & API endpoints
│  └─ utils.py      # Helper utilities (JSON export, snapshots, DB migration)
├─ app.py            # Entry point (creates the Flask app)
└─ requirements.txt

Adding new features#

1. Routes – Add view functions to web/routes.py and register them on the bp blueprint.
2. Templates – Place new Jinja2 files in web/templates/.
3. Static assets – Add CSS/JS files to web/static/ and reference them via url_for('static', filename='…').
4. Database changes – Extend web/models.py and, if needed, modify _ensure_provider_order_column() to handle migrations for SQLite.

Testing#

The repository includes pytest in the installed packages. Write unit tests under a tests/ directory and run:

shell script pytest

License#

llm_router_web is released under the same license as the parent llm-router project (see the repository’s LICENSE file).