Skip to content

fix: point metal-agent mlx-server install hint at the Homebrew formula#477

Merged
Defilan merged 1 commit into
defilantech:mainfrom
Defilan:fix/mlx-server-install-hint
May 17, 2026
Merged

fix: point metal-agent mlx-server install hint at the Homebrew formula#477
Defilan merged 1 commit into
defilantech:mainfrom
Defilan:fix/mlx-server-install-hint

Conversation

@Defilan
Copy link
Copy Markdown
Member

@Defilan Defilan commented May 17, 2026

What

Updates the metal-agent's mlx-server "binary not found" guidance to lead with brew install defilantech/tap/mlx-server, and refreshes the MLXServerExecutor doc comment for the repo's org move.

Why

When the mlx-server runtime landed (#471), defaultMLXServerPaths was set to the Homebrew prefixes anticipating a formula that did not exist yet. The "not found" error and log hint therefore told users only to pass --mlx-server-bin by hand, with no install path.

mlx-server now ships a Homebrew formula (defilantech/homebrew-tap), and the repo has moved to the defilantech org. The agent's guidance should reflect both.

How

  • resolveMLXServerBin error and the mlx-server binary not found log hint now lead with brew install defilantech/tap/mlx-server, then fall back to --mlx-server-bin, mirroring the existing vllm-swift hint.
  • defaultMLXServerPaths comment notes the paths are the Homebrew prefixes. The paths themselves are unchanged, since they were already correct.
  • MLXServerExecutor doc comment updated to github.com/defilantech/mlx-server (the repo moved orgs; the old URL still redirects).

No behavior change beyond the user-facing strings. go build ./cmd/metal-agent/ passes; no tests assert on these messages.

Follow-up to #471.

Checklist

  • make build passes locally (metal-agent builds)
  • Tests added/updated: not applicable, user-facing string and comment changes only
  • Commit messages follow conventional commits
  • All commits signed off (git commit -s) per DCO
  • Documentation updated: not applicable

The metal-agent's "mlx-server binary not found" error and log hint
told users only to pass --mlx-server-bin manually. mlx-server now ships
a Homebrew formula, so the guidance leads with
'brew install defilantech/tap/mlx-server', mirroring the vllm-swift
hint. The default search paths were already the Homebrew prefixes;
this makes the message match reality.

Also updates the MLXServerExecutor doc comment for the repo's move to
the defilantech org (github.com/defilantech/mlx-server).

Signed-off-by: Christopher Maher <chris@mahercode.io>
@codecov
Copy link
Copy Markdown

codecov Bot commented May 17, 2026

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
cmd/metal-agent/main.go 0.00% 4 Missing ⚠️

📢 Thoughts on this report? Let us know!

@Defilan Defilan merged commit 74b3333 into defilantech:main May 17, 2026
21 checks passed
@github-actions github-actions Bot mentioned this pull request May 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant