Skip to content

Latest commit

 

History

History
200 lines (149 loc) · 9.57 KB

File metadata and controls

200 lines (149 loc) · 9.57 KB

Local LLM Server Manager — User Guide Hub

Welcome to the Local LLM Server Manager (v3.17.0) User Guide. This document provides a complete guide to operating the dashboard, configuring local AI engines, and using generative studio tools.


Workspace Navigation

The desktop application organizes capabilities into dedicated workspaces using a collapsible Activity Rail (56 px collapsed / 200 px expanded) on the left flank and a compact 34 px Telemetry Ribbon in the titlebar:

flowchart TD
    App["Local LLM Server Manager (Port 5246)"]
    App --> Rail["Activity Rail\n(56px collapsed / 200px expanded)"]
    Rail --> Dom1["⚡ Studio\nSticker Studio, Images, Video, Audio & 3D Mesh"]
    Rail --> Dom2["📦 Models\nInstalled Models, Hugging Face Hub & CivitAI"]
    Rail --> Dom3["💻 Hardware Fit\nCan I Run It Sizing & Memory Offloading"]
    Rail --> Dom4["⚙️ Settings\nAuto-Discovery, Daemon Ports & Feature Packs"]
    Rail -.-> CompL["📖 Documentation\n(Companion Window / Drawer)"]
    Rail -.-> CompR["🤖 AI Assist\n(Companion Window / Drawer)"]
Loading

1. Hardware Telemetry & My Models

The Models workspace monitors active hardware metrics and manages local model weights.

Desktop Dashboard Overview

Key Capabilities

  • Live VRAM Bar: Displays total, used, and free GPU memory in real time via NVML CUDA telemetry.
  • Model Capability Badges: Identifies model capabilities (e.g., Coding & General, Reasoning, Math).
  • Interactive KV Cache Estimator: Drag the context length slider (up to 32,768 tokens) to preview memory consumption before loading models.
  • VRAM Orchestrator: Automatically frees GPU memory before heavy diffusion or 3D tasks start.
  • Unload All VRAM Button: Releases all active models from GPU memory with a single click.

Tip

Read the complete Engines & VRAM Guide and Ollama Engine Guide.


2. Model Discovery & Downloads

Download models directly without opening a web browser or using terminal commands.

Hugging Face Hub (GGUF & Multimodal)

Search community repositories, compare quantization levels (Q4_K_M, Q8_0), filter by input/output modalities, and stream downloads to disk.

Hugging Face Hub Search

CivitAI Model Hub (Checkpoints & LoRAs)

Search diffusion checkpoints, LoRA style adapters, and VAE models with real-time download counters and hardware compatibility badges.

CivitAI Models Hub


3. Hardware Fit Calculator (Can I Run It)

The Can I Run It workspace estimates whether an AI model fits within your system memory before downloading files.

Can I Run It Hardware Fit Calculator

Key Capabilities

  • Live GPU Detection: Queries your graphics card and system memory automatically.
  • Multi-Modality Sizing: Calculates memory consumption for Text LLMs, Diffusion Images, Video, Audio, and 3D Mesh models.
  • Visual Allocation Bar: Color-coded breakdown of Model Weights, Context/KV Cache, CUDA Overhead, and Free Headroom.
  • Layer Offloading Calculation: Predicts the exact number of transformer layers that fit in GPU VRAM versus CPU RAM.
  • Performance Throughput: Provides real-time token per second estimates for your hardware.

Tip

Read the dedicated Can I Run It Hardware Fit Guide.


4. Multimodal Generation Workflows

The Workflows workspace provides generation pipelines across five creative modalities:

AI Generation Workflows

Modality Supported Models Output Formats Dedicated Guide
Sticker Studio SDXL, SD 1.5, FLUX PNG (32-bit Transparent) Sticker Studio Guide
Image Generation FLUX.1, SDXL, SD 1.5 PNG, WebP Image Generation Guide
Video Generation Wan 2.2, LTX-Video 2.5, HunyuanVideo MP4 Video Generation Guide
Audio & Speech Kokoro TTS, Stable Audio Open, YuE WAV, MP3 Audio & Music Guide
3D Mesh TRELLIS V2, Hunyuan3D v2 GLB, OBJ 3D Mesh Guide

Sticker Studio Walkthrough

The Sticker Studio creates die-cut vinyl stickers from image references or text descriptions:

  1. Click ⚡ Studio in the Activity Rail and select Sticker Studio.
  2. Drop a reference image (PNG, JPG, WebP) into the Input Deck drop zone, or type a custom prompt.
  3. Select an art style preset chip (Die-Cut Vinyl, Holographic, Chibi Anime, 80s Retro, Pop Art, or Watercolor).
  4. Verify that Auto-Cutout is checked to remove backgrounds automatically.
  5. Set the Die-Cut Border Width slider (0–24 px).
  6. Click ✨ Generate Sticker.
  7. Monitor progress through the 4-stage pipeline tracker:
    • Diffusion Generation ➔ Subject Isolation ➔ Contour Application ➔ Ready.
  8. Click 📋 Copy PNG to copy the 32-bit transparent image to the clipboard, or click 💾 Save File to write to disk.

Tip

Read the complete Sticker Studio Guide for full style token references and VRAM requirements.

Real Engine Test Flight

Before starting complex renders, use the Test Flight control panel in the studio header:

  1. Select your target modality (Text, Image, Video, or Audio).
  2. Choose a starter prompt.
  3. Click 🚀 Launch Test Flight.
  4. The system validates network readiness and GPU memory in seconds.

5. In-App AI Assistant & Companion Windows

The AI Assistant workspace provides interactive guidance, screenshot diagnostics, and app control without consuming local GPU memory.

flowchart LR
    LeftCompanion["Documentation Window\n(Left Flank)"] <-->|Magnetic Proximity Snap| MainWindow["Main Dashboard Window\n(Center)"]
    MainWindow <-->|Magnetic Proximity Snap| RightCompanion["AI Assist Window\n(Right Flank)"]
Loading

Key Capabilities

  • External Gateway: Connects to LiteLLM or Vertex AI Gemini Flash to keep local GPU memory free for generation.
  • Multimodal Attachments: Paste screenshots (Ctrl+V) to diagnose ComfyUI errors or review outputs.
  • Magnetic Companion Windows: Detach the assistant into a floating window that docks magnetically to the right flank.
  • Lockstep Movement: Moving the main window moves docked companion windows automatically.

6. Application Settings & Engine Controls

The Settings workspace centralizes engine paths, port bindings, and optional component management.

Application Settings

Key Settings

  • Auto-Detect Installed Tools: Scans system drives to locate Ollama, ComfyUI, Forge, and Kokoro TTS automatically.
  • Modular Feature Packs: Install or remove ext_video and ext_audio packages on demand.
  • Network Endpoints: Displays auto-detected LAN IP addresses and remote MCP connection URLs.

Comprehensive Guides Index