model-router-cli 1.0.0__tar.gz → 1.0.2__tar.gz

{model_router_cli-1.0.0 → model_router_cli-1.0.2}/PKG-INFO

@@ -1,8 +1,9 @@
 Metadata-Version: 2.4
 Name: model-router-cli
-Version: 1.0.0
+Version: 1.0.2
 Summary: Intelligent, explainable LLM request routing platform & AI Traffic Control Room
 Author-email: PicadoLabs <picadolabs@gmail.com>
+Maintainer-email: Kaap10 <picadolabs@gmail.com>
 License: MIT
 Project-URL: Homepage, https://picadolabs.me
 Project-URL: Repository, https://github.com/PicadoLabs/ai-model-router
@@ -37,6 +38,10 @@ Dynamic: license-file
 
 # Model Router
 
+[![PyPI - Version](https://img.shields.io/pypi/v/model-router-cli?logo=pypi&logoColor=white&color=blue)](https://pypi.org/project/model-router-cli/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/model-router-cli?logo=python&logoColor=white)](https://pypi.org/project/model-router-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Intelligent, explainable, cost- and latency-aware LLM request routing platform and AI Traffic Control Room.
 
 ---
@@ -103,9 +108,32 @@ The platform is designed local-first, allowing full local development and testin
 - Node.js 18+ and npm
 - (Optional) [Ollama](https://ollama.com/) for local model inference
 
+## 📦 Quick Installation (via PyPI)
+
+Install Model Router and its embedded **AI Traffic Control Room** dashboard directly from PyPI:
+
+```bash
+pip install model-router-cli
+```
+
+### Quick Commands:
+```bash
+# Run system diagnostics & environment checks
+modelrouter doctor
+
+# Launch the Traffic Control Room Dashboard & API Gateway in your browser
+modelrouter ui --open-browser
+
+# Route a prompt and inspect the explainability decision (Dry Run)
+modelrouter route "Write an optimized async task worker in Python"
+
+# Route and execute inference through the optimal provider
+modelrouter run "Explain the difference between zero-shot and few-shot prompting"
+```
+
 ---
 
-## Installation & Setup
+## Installation & Setup (from Source)
 
 ### 1. Clone the Repository
 ```bash
@@ -189,23 +217,29 @@ npm run dev
 
 ## CLI Usage
 
-The built-in Typer CLI provides terminal commands for inspection, diagnostics, and testing:
+The built-in Typer CLI provides terminal commands for inspection, diagnostics, and testing (use `modelrouter` if installed via pip, or `python backend/app/cli/main.py` from source):
 
 ```bash
+# Launch the AI Traffic Control Room Web UI and API Gateway
+modelrouter ui --open-browser
+
 # Run system diagnostics & provider health checks
-python backend/app/cli/main.py doctor
+modelrouter doctor
 
 # Inspect routing decision for a prompt without executing (Dry Run)
-python backend/app/cli/main.py route "Write a Python function to parse JSON"
+modelrouter route "Write a Python function to parse JSON"
 
 # Route and execute a query through the selected model
-python backend/app/cli/main.py run "Debug this distributed async deadlock in worker pool"
+modelrouter run "Debug this distributed async deadlock in worker pool"
 
 # List all registered models in the catalog
-python backend/app/cli/main.py models
+modelrouter models
+
+# View recent routed traffic logs
+modelrouter traffic
 
 # View system-wide routing performance and cost savings analytics
-python backend/app/cli/main.py analytics
+modelrouter analytics
 ```
 
 ---
@@ -338,6 +372,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 Maintained and architected by **PicadoLabs**.
 
+- **Maintainer**: [@Kaap10](https://github.com/Kaap10)
 - **Organization**: [PicadoLabs](https://github.com/PicadoLabs)
 - **Website**: [https://picadolabs.me](https://picadolabs.me)
 - **Contact**: [picadolabs@gmail.com](mailto:picadolabs@gmail.com)

{model_router_cli-1.0.0 → model_router_cli-1.0.2}/README.md

@@ -1,5 +1,9 @@
 # Model Router
 
+[![PyPI - Version](https://img.shields.io/pypi/v/model-router-cli?logo=pypi&logoColor=white&color=blue)](https://pypi.org/project/model-router-cli/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/model-router-cli?logo=python&logoColor=white)](https://pypi.org/project/model-router-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Intelligent, explainable, cost- and latency-aware LLM request routing platform and AI Traffic Control Room.
 
 ---
@@ -66,9 +70,32 @@ The platform is designed local-first, allowing full local development and testin
 - Node.js 18+ and npm
 - (Optional) [Ollama](https://ollama.com/) for local model inference
 
+## 📦 Quick Installation (via PyPI)
+
+Install Model Router and its embedded **AI Traffic Control Room** dashboard directly from PyPI:
+
+```bash
+pip install model-router-cli
+```
+
+### Quick Commands:
+```bash
+# Run system diagnostics & environment checks
+modelrouter doctor
+
+# Launch the Traffic Control Room Dashboard & API Gateway in your browser
+modelrouter ui --open-browser
+
+# Route a prompt and inspect the explainability decision (Dry Run)
+modelrouter route "Write an optimized async task worker in Python"
+
+# Route and execute inference through the optimal provider
+modelrouter run "Explain the difference between zero-shot and few-shot prompting"
+```
+
 ---
 
-## Installation & Setup
+## Installation & Setup (from Source)
 
 ### 1. Clone the Repository
 ```bash
@@ -152,23 +179,29 @@ npm run dev
 
 ## CLI Usage
 
-The built-in Typer CLI provides terminal commands for inspection, diagnostics, and testing:
+The built-in Typer CLI provides terminal commands for inspection, diagnostics, and testing (use `modelrouter` if installed via pip, or `python backend/app/cli/main.py` from source):
 
 ```bash
+# Launch the AI Traffic Control Room Web UI and API Gateway
+modelrouter ui --open-browser
+
 # Run system diagnostics & provider health checks
-python backend/app/cli/main.py doctor
+modelrouter doctor
 
 # Inspect routing decision for a prompt without executing (Dry Run)
-python backend/app/cli/main.py route "Write a Python function to parse JSON"
+modelrouter route "Write a Python function to parse JSON"
 
 # Route and execute a query through the selected model
-python backend/app/cli/main.py run "Debug this distributed async deadlock in worker pool"
+modelrouter run "Debug this distributed async deadlock in worker pool"
 
 # List all registered models in the catalog
-python backend/app/cli/main.py models
+modelrouter models
+
+# View recent routed traffic logs
+modelrouter traffic
 
 # View system-wide routing performance and cost savings analytics
-python backend/app/cli/main.py analytics
+modelrouter analytics
 ```
 
 ---
@@ -301,6 +334,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 Maintained and architected by **PicadoLabs**.
 
+- **Maintainer**: [@Kaap10](https://github.com/Kaap10)
 - **Organization**: [PicadoLabs](https://github.com/PicadoLabs)
 - **Website**: [https://picadolabs.me](https://picadolabs.me)
 - **Contact**: [picadolabs@gmail.com](mailto:picadolabs@gmail.com)

{model_router_cli-1.0.0 → model_router_cli-1.0.2}/backend/app/cli/main.py

@@ -269,17 +269,34 @@ def analytics():
 def ui(
     host: str = typer.Option("127.0.0.1", "--host", "-h", help="Host address to bind the web server"),
     port: int = typer.Option(8000, "--port", "-p", help="Port to run the Model Router Control Room on"),
+    open_browser: bool = typer.Option(False, "--open-browser", help="Automatically open dashboard in default web browser"),
 ):
     """Launch the Model Router API Gateway & AI Traffic Control Room UI."""
     import uvicorn
-    console.print(Panel.fit(
+    import webbrowser
+    import threading
+    import time
+
+    url = f"http://{host}:{port}"
+    message = (
         f"[bold cyan]Starting Model Router AI Traffic Control Room[/bold cyan]\n"
-        f"Web Dashboard: [bold green]http://{host}:{port}[/bold green]\n"
-        f"API Documentation: [bold green]http://{host}:{port}/docs[/bold green]",
+        f"Web Dashboard: [bold green]{url}[/bold green]\n"
+        f"API Documentation: [bold green]{url}/docs[/bold green]"
+    )
+    console.print(Panel.fit(
+        message,
         title="MODEL ROUTER UI LAUNCHER",
         border_style="cyan"
     ))
-    uvicorn.run("main:app", host=host, port=port, reload=False, app_dir=os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..")))
+
+    if open_browser:
+        def _open():
+            time.sleep(1.2)
+            webbrowser.open(url)
+        threading.Thread(target=_open, daemon=True).start()
+
+    from app.server import app as fastapi_app
+    uvicorn.run(fastapi_app, host=host, port=port, log_level="info")
 
 
 if __name__ == "__main__":

model_router_cli-1.0.2/backend/app/server.py

@@ -0,0 +1,111 @@
+import asyncio
+import json
+import os
+from contextlib import asynccontextmanager
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.staticfiles import StaticFiles
+from fastapi.responses import FileResponse
+from sse_starlette.sse import EventSourceResponse
+from sqlalchemy import select, desc
+
+from app.config.settings import get_settings
+from app.storage.database import init_db, AsyncSessionLocal
+from app.storage.models import RequestRecord
+from app.api.routes import router as api_router
+
+settings = get_settings()
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # Initialize SQLite database and seed defaults
+    await init_db()
+    yield
+
+
+app = FastAPI(
+    title="Model Router",
+    description="Intelligent LLM Request Routing Platform — AI Traffic Control Room",
+    version="1.0.0",
+    lifespan=lifespan,
+)
+
+# CORS configuration
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+app.include_router(api_router)
+
+
+@app.get("/api/traffic/stream")
+async def stream_live_traffic():
+    """
+    SSE Live Stream endpoint for the Traffic Control Room visualization.
+    Pushes newly persisted requests to connected frontend clients.
+    """
+    async def event_generator():
+        last_seen_id = None
+        while True:
+            try:
+                async with AsyncSessionLocal() as session:
+                    res = await session.execute(
+                        select(RequestRecord).order_by(desc(RequestRecord.timestamp)).limit(1)
+                    )
+                    latest = res.scalar_one_or_none()
+                    if latest and latest.request_id != last_seen_id:
+                        last_seen_id = latest.request_id
+                        payload = {
+                            "request_id": latest.request_id,
+                            "timestamp": latest.timestamp.isoformat() if latest.timestamp else "",
+                            "prompt": latest.prompt,
+                            "task_type": latest.task_type,
+                            "complexity": latest.complexity,
+                            "selected_model": latest.selected_model,
+                            "provider": latest.provider,
+                            "status": latest.status,
+                            "total_latency_ms": latest.total_latency_ms,
+                            "estimated_cost": latest.estimated_cost,
+                        }
+                        yield {
+                            "event": "traffic_event",
+                            "data": json.dumps(payload),
+                        }
+            except Exception:
+                pass
+            await asyncio.sleep(1.5)
+
+    return EventSourceResponse(event_generator())
+
+
+# Serve Bundled Frontend (SPA) if static directory exists
+STATIC_DIR = os.path.join(os.path.dirname(__file__), "static")
+
+if os.path.exists(STATIC_DIR):
+    assets_dir = os.path.join(STATIC_DIR, "assets")
+    if os.path.exists(assets_dir):
+        app.mount("/assets", StaticFiles(directory=assets_dir), name="assets")
+
+    @app.get("/{full_path:path}")
+    async def serve_spa(full_path: str):
+        if full_path.startswith("api/") or full_path.startswith("docs") or full_path.startswith("openapi.json"):
+            raise HTTPException(status_code=404, detail="Not Found")
+        
+        target_file = os.path.join(STATIC_DIR, full_path)
+        if os.path.exists(target_file) and os.path.isfile(target_file):
+            return FileResponse(target_file)
+        return FileResponse(os.path.join(STATIC_DIR, "index.html"))
+else:
+    @app.get("/")
+    async def root():
+        return {
+            "message": "Model Router AI Control Room Backend is active.",
+            "docs": "/docs",
+            "health": "/api/health",
+        }
+

{model_router_cli-1.0.0 → model_router_cli-1.0.2}/backend/model_router_cli.egg-info/PKG-INFO

@@ -1,8 +1,9 @@
 Metadata-Version: 2.4
 Name: model-router-cli
-Version: 1.0.0
+Version: 1.0.2
 Summary: Intelligent, explainable LLM request routing platform & AI Traffic Control Room
 Author-email: PicadoLabs <picadolabs@gmail.com>
+Maintainer-email: Kaap10 <picadolabs@gmail.com>
 License: MIT
 Project-URL: Homepage, https://picadolabs.me
 Project-URL: Repository, https://github.com/PicadoLabs/ai-model-router
@@ -37,6 +38,10 @@ Dynamic: license-file
 
 # Model Router
 
+[![PyPI - Version](https://img.shields.io/pypi/v/model-router-cli?logo=pypi&logoColor=white&color=blue)](https://pypi.org/project/model-router-cli/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/model-router-cli?logo=python&logoColor=white)](https://pypi.org/project/model-router-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Intelligent, explainable, cost- and latency-aware LLM request routing platform and AI Traffic Control Room.
 
 ---
@@ -103,9 +108,32 @@ The platform is designed local-first, allowing full local development and testin
 - Node.js 18+ and npm
 - (Optional) [Ollama](https://ollama.com/) for local model inference
 
+## 📦 Quick Installation (via PyPI)
+
+Install Model Router and its embedded **AI Traffic Control Room** dashboard directly from PyPI:
+
+```bash
+pip install model-router-cli
+```
+
+### Quick Commands:
+```bash
+# Run system diagnostics & environment checks
+modelrouter doctor
+
+# Launch the Traffic Control Room Dashboard & API Gateway in your browser
+modelrouter ui --open-browser
+
+# Route a prompt and inspect the explainability decision (Dry Run)
+modelrouter route "Write an optimized async task worker in Python"
+
+# Route and execute inference through the optimal provider
+modelrouter run "Explain the difference between zero-shot and few-shot prompting"
+```
+
 ---
 
-## Installation & Setup
+## Installation & Setup (from Source)
 
 ### 1. Clone the Repository
 ```bash
@@ -189,23 +217,29 @@ npm run dev
 
 ## CLI Usage
 
-The built-in Typer CLI provides terminal commands for inspection, diagnostics, and testing:
+The built-in Typer CLI provides terminal commands for inspection, diagnostics, and testing (use `modelrouter` if installed via pip, or `python backend/app/cli/main.py` from source):
 
 ```bash
+# Launch the AI Traffic Control Room Web UI and API Gateway
+modelrouter ui --open-browser
+
 # Run system diagnostics & provider health checks
-python backend/app/cli/main.py doctor
+modelrouter doctor
 
 # Inspect routing decision for a prompt without executing (Dry Run)
-python backend/app/cli/main.py route "Write a Python function to parse JSON"
+modelrouter route "Write a Python function to parse JSON"
 
 # Route and execute a query through the selected model
-python backend/app/cli/main.py run "Debug this distributed async deadlock in worker pool"
+modelrouter run "Debug this distributed async deadlock in worker pool"
 
 # List all registered models in the catalog
-python backend/app/cli/main.py models
+modelrouter models
+
+# View recent routed traffic logs
+modelrouter traffic
 
 # View system-wide routing performance and cost savings analytics
-python backend/app/cli/main.py analytics
+modelrouter analytics
 ```
 
 ---
@@ -338,6 +372,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 Maintained and architected by **PicadoLabs**.
 
+- **Maintainer**: [@Kaap10](https://github.com/Kaap10)
 - **Organization**: [PicadoLabs](https://github.com/PicadoLabs)
 - **Website**: [https://picadolabs.me](https://picadolabs.me)
 - **Contact**: [picadolabs@gmail.com](mailto:picadolabs@gmail.com)

{model_router_cli-1.0.0 → model_router_cli-1.0.2}/backend/model_router_cli.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 LICENSE
 README.md
 pyproject.toml
+backend/app/server.py
 backend/app/analytics/service.py
 backend/app/analyzer/analyzer.py
 backend/app/analyzer/heuristics.py

{model_router_cli-1.0.0 → model_router_cli-1.0.2}/pyproject.toml

@@ -4,13 +4,16 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "model-router-cli"
-version = "1.0.0"
+version = "1.0.2"
 description = "Intelligent, explainable LLM request routing platform & AI Traffic Control Room"
 readme = "README.md"
 requires-python = ">=3.10"
 authors = [
     { name = "PicadoLabs", email = "picadolabs@gmail.com" }
 ]
+maintainers = [
+    { name = "Kaap10", email = "picadolabs@gmail.com" }
+]
 license = { text = "MIT" }
 keywords = ["llm", "ai", "router", "fastapi", "ollama", "openai", "cost-optimization"]
 classifiers = [