53d9cca82d
Release 2.0.4-beta.6: Local workspace workflow + Vision batch processing
...
- Complete local development cycle: clone → repair → run/show/server on
workspace paths without HuggingFace round-trips
- Vision processing now defaults to safe chunking (one image at a time,
prevents OOM + hallucination)
- Resumable clone with --force-resume and deterministic temp cache naming
- Improved test infrastructure (umbrella marker convention)
- 161 Wet Umbrella tests passing including new Vision→Geo pipe integration tests
See CHANGELOG.md for complete details.
2026-01-07 17:11:07 +01:00
25609e4dcb
Release 2.0.4-beta.5: Community repair tool + OS-agnostic benchmarking
...
Closes #49 (Mistral Tokenizer Bug)
Major features:
- Workspace Infrastructure (ADR-018 Phase 0a): Managed workspace detection,
provenance metadata, backward compatible with unmanaged workspaces
- Convert Operation (ADR-018 Phase 1): `mlxk convert --repair-index` fixes
mlx-vlm #624 affected models (7+ models including Qwen2.5-VL, gemma-3)
- Resumable Pull: Auto-detect partial downloads with `--force-resume`
- Wet Umbrella Test Integration: Single entry point for all real model tests
Fixes:
- #49 : BPE space markers now correctly converted (Mistral-family models)
- Vision Portfolio Discovery: Filter by capabilities instead of model_type
- Memory Cleanup Hook: Triggers for both live_e2e and wet markers
Test suite: 528 passed, 60 skipped (Python 3.9-3.14)
2025-12-31 16:05:18 +01:00
86f669dc82
Release 2.0.4-beta.1: Vision + Pipes + Memory
...
- Vision Support (Issue #45 ): CLI + Server with OpenAI-compatible image API, EXIF metadata
- Unix Pipes (ADR-014): stdin support, isatty detection, SIGPIPE handling
- Memory-Aware Loading (ADR-016): Pre-load checks with >70% RAM warnings
- Python 3.9-3.14: Full compatibility verified (476-485 tests passing)
- Fixed: --log-json regression (Issue #44 ), Vision multimodal history filtering
See CHANGELOG.md for complete details.
2025-12-16 19:35:30 +01:00
05f1c30486
Release 2.0.3: Foundation for pipes
...
Foundation release for Unix pipe integration with stderr separation,
benchmark infrastructure, and reasoning control improvements.
Breaking Changes:
- stdout/stderr separation (Issue #43 ) - errors to stderr in human mode
- JSON mode unchanged (all output to stdout)
Features:
- Benchmark reporting infrastructure (ADR-013 Phase 0)
- --no-reasoning flag (Issue #40 partial - GPT-OSS/QwQ only)
- Interactive mode reasoning control (review_report.md fixes)
Bug Fixes:
- huggingface-hub 1.x incompatibility (critical dependency fix)
- Streaming parity tests refactored (Portfolio Discovery)
Testing:
- 308 tests passing (Python 3.9-3.13)
- 35 skipped (opt-in live tests)
- 79/91 E2E tests passing with HF_HOME
See CHANGELOG.md for complete details and migration guide.
2025-11-17 22:54:06 +01:00
21cf188fcc
Release 2.0.1: Portfolio Discovery + CLI Exit Code Fixes
...
Issue #32 : Stop token Portfolio Discovery validates generic fix across all models
- Auto-discovers MLX chat models in HF_HOME with 4-filter validation
- RAM-aware testing (40-70% budgets) prevents OOM
- Empirical report generation (stop_token_config_report.json)
- Fallback to 3 predefined models without HF_HOME
- Implementation: tests_2.0/test_stop_tokens_live.py (~110 LOC)
Issue #38 : CLI exit codes now propagate run command errors correctly
- Both text and JSON modes return exit code 1 on model execution failures
- Fixed: run_model() now returns error strings in both modes
- Implementation: mlxk2/operations/run.py + mlxk2/cli.py error detection
- New tests: tests_2.0/test_cli_run_exit_codes.py (9 comprehensive tests)
Testing: 306 passed, 20 skipped (zero regressions)
Docs: Updated README, TESTING, SECURITY for 2.0.1 stable release
Version: 2.0.0 → 2.0.1 (mlxk2/__init__.py)
2025-11-08 20:28:54 +01:00
f5fe1dd061
Release 2.0.0-beta.5: Enhanced error handling & bug fixes
...
Features:
- Enhanced error handling & logging (ADR-004): Unified error envelope, structured logging with JSON support, request correlation
- Legacy format detection (Issue #37 ): Runtime compatibility check for weight file formats
Bug Fixes:
- Issue #37 : Models with legacy weight formats now correctly detected as runtime-incompatible
- CLI regression fix: mlxk2 without arguments shows help instead of JSON error
Test Status: 295/295 passed, 14 skipped
2025-10-21 00:24:47 +02:00
9261bc0c4e
2.0.0-beta.3: Feature Complete - Clone Implementation & Issue Resolution
...
- Clone Feature (Issue #29 ): Complete workspace-based workflow with ADR-007
- Pull Preflight (Issue #30 ): Prevents cache pollution from gated/private repos
- Lenient MLX Detection (Issue #31 ): Framework detection beyond mlx-community
- Multi-shard Health (Issue #27 ): Strict completeness validation
- Full JSON API 0.1.4: Complete schema for all 10 commands
- Test Suite: 254/254 passed, comprehensive validation
See CHANGELOG.md fnd TESTING.md or technical implementation details.
2025-09-18 14:09:32 +02:00
57bf6d86be
2.0.0-beta.3: Feature Complete - Full 1.1.1 Parity Achieved
...
Major Features Added:
• Complete run command implementation with interactive/single-shot modes
• MLXRunner core engine ported from 1.x with modular architecture
• OpenAI-compatible server with SIGINT-robust supervisor mode
• Experimental push feature properly isolated behind environment variable
Key Improvements:
- Full feature parity with 1.1.1 stable releases
- Enhanced human output formatting across all commands
- Clean separation of stable (184 tests) vs experimental features
- Updated demo GIF showcasing improved 2.0 interface
Fixes:
- Pull operation cache pollution (Issue #30 ) with preflight access checks
- Test stability improvements across all environments
Architecture:
- Modular runner design with focused helper modules
- Thread-safe model loading and memory management
- stable testing across Python 3.9-3.13
Ready for use as comprehensive 1.x alternative.
2025-09-14 18:04:18 +02:00
3f57248121
2.0.0-alpha.3: lenient MLX detection + push branch handling
...
- Detect MLX/chat via README front‑matter + tokenizer; unify list/show; human list filters aligned (Refs #31 )
- Push: create missing branch with --create and retry once on “Invalid rev id”; tolerate missing branches
offline; no‑op still creates branch with --create
- Tests: add offline retry test; detection/human coverage; live list (opt‑in); 98/98 passing
- Docs/Meta: CHANGELOG/TESTING/README/SECURITY/CLAUDE updated; hard split 1.x from this branch; Apache‑2.0 + NOTICE
2025-09-08 01:14:01 +02:00
eedb91b75c
Feat: add experimental push (2.0.0-alpha.2)
...
- Push (upload-only): quiet JSON by default; capture hub logs in data.hf_logs
- No-op detection aligned to hub signal; clear commit fields; uploaded_files_count=0
- Add --dry-run (plan vs remote) and --check-only (offline preflight); merge .hfignore; extend
default ignores
- Human output: concise; --verbose shows commit URL; JSON shape unchanged
- Tests: add offline dry-run cases; live push remains opt-in (wet/live_push)
- Docs: README push section updated; TESTING.md reference + mini-matrix;
- Changelog: add 2.0.0-alpha.2; note Issue #31 under 1.1.1 pending
- Spec: keep schema stable (0.1.3); CLI/version docs consistent
2025-09-05 22:42:39 +02:00
19a66674c0
2.0.0-alpha.1: human output default; strict health ( #27 , PyTorch index)
...
See CHANGELOG.md and README.md
2025-08-31 22:25:43 +02:00
2624210353
Consolidate JSON API; add --version; health in list/show (spec json-0.1.2)
...
- Enforce strict JSON API in tests
- Introduce --version --json as sole version reporter
2025-08-31 15:17:19 +02:00
c5777a3e7a
MLX-Knife 2.0 Session 2 Complete + Session 3 Major Progress: Production-Ready Alpha
...
Session 2 Achievements (100% Complete):
• All 5 operations implemented: list, health, show, pull, rm
• CLI compatibility: fuzzy matching, @hash syntax, short names
• Lock detection: New safety feature replacing interactive prompts
• Pull corruption recovery: Clean rm→pull workflow
• Hash fuzzy matching: show "model@3df9bfd" works with short hashes
Session 3 Major Progress (70% Complete):
• JSON API Specification v0.1.1: Complete and production-ready
• Full SHA hashes: 40-char hashes in list output for broke-cluster
• Show command: --files and --config options fully implemented
• JSON-flag enforcement: --json required in alpha for correct usage
Key Features:
• Broke-cluster integration ready with enforced --json flag
• Real-world tested: rm→pull workflow validated with corrupted cache
• Lock cleanup: 9 lock files properly cleaned during rm operations
• Sanitized JSON: No cache paths or implementation details exposed
Testing Status: Basic unit tests implemented, manual validation successful
Note: Test suite requires update for JSON API Specification v0.1.1
Package: Installable as mlxk-json alongside 1.1.0
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-08-27 21:36:35 +02:00
d603cde9d5
MLX-Knife 2.0 Session 1: JSON-First Foundation
...
✅ FOUNDATION COMPLETE: Working `python -m mlxk2.cli list` command
Architecture:
- Clean-room implementation (145 lines total)
- JSON-first design for broke-cluster automation
- Modular structure: core/operations/output separation
Deliverables:
- mlxk2/core/cache.py: Cache path management (35 lines)
- mlxk2/operations/list.py: Model discovery with JSON output (41 lines)
- mlxk2/cli.py: CLI entry point with error handling (69 lines)
- docs/: Complete ADR and implementation plan documentation
Success Metrics Achieved:
✅ 12 models detected and JSON-formatted
✅ Consistent schema: status/command/data/error
✅ broke-cluster ready: `jq -r '.data.models[].name'`
✅ 4x faster than planned (1 hour vs 4 hour target)
Next: Session 2 - health, pull, rm operations
2025-08-26 19:25:50 +02:00
The BROKE Cluster Team