Skip to content

v2.6.0 — Model Profile Import Export Design

Choose a tag to compare

View all tags
@acari-git acari-git released this 15 Jun 14:05
· 4 commits to main since this release
v2.6.0
05e056f

v2.6.0

This is a docs-only release.

Summary

v2.6.0 adds the Model Profile Import / Export design.

The goal is to make future model profile backup, migration, and sharing safer by defining the file format, validation behavior, conflict handling, and security boundaries before implementation.

No app code was changed in this release.

Added

  • Added docs/model_profile_import_export.md
  • Added README links to the new design document
  • Updated onboarding guidance notes
  • Updated task notes for v2.6.0

Design Scope

The design covers:

  • JSON export format
  • versioned schema
  • profile metadata export
  • import preview
  • schema validation
  • profile validation
  • conflict handling
  • Advanced Launch Options handling
  • local path handling
  • UI flow
  • error messages
  • testing plan
  • future work

Safety Boundary

The design keeps import/export limited to model profile metadata.

It does not include:

  • model weights
  • model caches
  • API keys
  • Hugging Face tokens
  • GitHub tokens
  • secrets
  • executable paths by default
  • automatic server start
  • external process ownership changes

Direct Mode Boundary

Direct Mode remains unchanged:

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

Model profile import/export is a metadata management feature. It does not proxy inference requests, add a chat UI, download models, delete models, or become a multi-backend router.

Future Implementation Notes

A future implementation should include:

  • Export Profiles action
  • Import Profiles action
  • Import Preview sheet
  • conflict handling options: skip, rename, replace
  • privacy warning before export
  • validation before import
  • no automatic process launch after import

Not Changed

  • No Swift changes
  • No Xcode project changes
  • No build setting changes
  • No new app binary
  • No new zip asset
  • No inference proxy
  • No chat UI
  • No model downloader
  • No model deleter
  • No multi-backend wrapper

Current Binary Asset

The current downloadable app binary remains the v2.4.0 unsigned build:

MLXServerManager-v2.4.0-unsigned.zip

This v2.6.0 release does not include a new binary asset.

Assets 2
Loading