Skip to content

docs: rewrite README with competitive positioning#7

Merged
weklund merged 3 commits intomainfrom
docs/readme-competitive-positioning
Apr 2, 2026
Merged

docs: rewrite README with competitive positioning#7
weklund merged 3 commits intomainfrom
docs/readme-competitive-positioning

Conversation

@weklund
Copy link
Copy Markdown
Owner

@weklund weklund commented Apr 2, 2026

Summary

  • Rewrites the README tagline and opening to lead with the core value prop: simultaneous multi-model serving behind one endpoint
  • Adds a "Why mlx-stack?" section with a direct comparison table vs Ollama, LM Studio, and llama.cpp
  • Reframes feature highlights around the three key differentiators: agent-first multi-tier serving, 24/7 headless Mac Mini operation, and hardware-aware automatic model selection
  • Removes the old generic "Feature Highlights" bullet list in favor of narrative subsections that explain why each capability matters

Test plan

  • Verify README renders correctly on GitHub (table, code blocks, ASCII diagram)
  • Confirm all ToC links resolve to the correct anchors
  • Check that no existing sections below Installation were affected

🤖 Generated with Claude Code

weklund and others added 3 commits April 2, 2026 08:56
litellm requires the [proxy] extra for proxy server dependencies (backoff,
prisma, etc.) — without it, mlx-stack up crashes with ModuleNotFoundError.
Also bumps from v1.67.2 to v1.83.0, the first verified-clean release after
CVE-2026-33634 (supply chain attack on v1.82.7/1.82.8).

Fixes #5

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Extract _build_install_spec helper so ensure_dependency post-install
error and _warn_version_mismatch both include [proxy] extra for litellm.
Add sync guard test for _TOOL_EXTRAS keys.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The README documented features accurately but didn't make the case for
why someone should choose mlx-stack over Ollama, LM Studio, or llama.cpp.
Rewrites the tagline, adds a "Why mlx-stack?" section with a direct
comparison table, and reframes around the three core differentiators:
multi-model simultaneous serving, agent-first design, and 24/7 headless
operation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@weklund weklund merged commit 01974cd into main Apr 2, 2026
1 check passed
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