Skip to content

v2.4.0 — First-run Onboarding Guidance

Choose a tag to compare

View all tags
@acari-git acari-git released this 15 Jun 11:56
· 6 commits to main since this release
v2.4.0
f4fd9f5

v2.4.0

Summary

v2.4.0 adds the initial first-run onboarding guidance panel.

The goal is to help new users understand what to configure next without adding a large wizard, automatic installer, model downloader, chat UI, or inference proxy.

Added

  • Added lightweight Onboarding Guidance panel
  • Added OnboardingGuidance model
  • Added OnboardingGuidanceView
  • Added state-specific first-run guidance
  • Added Direct Mode note inside the guidance panel
  • Updated README and onboarding docs
  • Updated task notes for v2.4.0

Guidance States

The onboarding panel provides short guidance for:

  • missing mlx_lm.server executable path
  • missing or incomplete model profile
  • Not Running / Not Connected state
  • External Server Detected state
  • Adopted External Server state
  • Managed Server Running state

Behavior

The guidance panel is informational only.

It does not:

  • automatically configure paths
  • install dependencies
  • download models
  • start external processes
  • stop external processes
  • restart external processes
  • change Advanced Launch Options
  • change lifecycle safety rules

Direct Mode Boundary

Direct Mode remains unchanged:

OpenAI-compatible client -> mlx_lm.server or adopted external server -> MLX model

MLX Server Manager does not proxy inference requests, act as a chat UI, or become a multi-backend wrapper.

Ownership Boundary

The existing ownership boundary remains unchanged.

External Server Detected and Adopted External Server are not app-managed processes.

MLX Server Manager does not take ownership of external servers, stop them, restart them, kill them, monitor their memory, or collect their logs.

Verification

  • Debug build succeeded
  • Release zip created
  • Onboarding Guidance panel added
  • State-specific guidance added
  • Start / Stop / Restart safety unchanged
  • Adopt / Forget behavior unchanged
  • Advanced Launch Options unchanged
  • No inference proxy added
  • No chat UI added
  • No model downloader added

Asset

MLXServerManager-v2.4.0-unsigned.zip

SHA-256:

ad91d6c9794a496acd44ec4fdf89c89f02e4020169978249b33518c270b75fa5

Size: 361K

Assets 3
Loading