Release MLX Knife 1.0.0 - Stable Release with PyPI Publication

Major milestone: First stable release with official PyPI distribution.

  New Features:
  - PyPI publication: Now installable via \`pip install mlx-knife\`
  - Official CLI-only designation with clear API policy
  - Absolute GitHub URLs for PyPI package display (logo + demo)

  Documentation Updates:
  - All docs updated to v1.0.0 (README, CHANGELOG, TESTING, SECURITY, CLAUDE.md)
  - Added PyPI installation instructions to README
  - Updated supported versions tables
  - Clarified CLI-only usage policy

  Release Highlights:
  - Transition from 1.0-rc3 to stable 1.0.0
  - Production-ready with 104/104 tests passing
  - Global accessibility via PyPI distribution
  - Comprehensive documentation overhaul

  Ready for community adoption and production use.
This commit is contained in:
The BROKE Team
2025-08-15 13:56:08 +02:00
parent 8e65ef03c7
commit 29548fe3f1
8 changed files with 31 additions and 10 deletions
+16 -4
View File
@@ -1,12 +1,14 @@
# <img src="broke-logo.png" alt="BROKE Logo" width="60" style="vertical-align: middle;"> MLX Knife
# <img src="https://github.com/mzau/mlx-knife/raw/main/broke-logo.png" alt="BROKE Logo" width="60" style="vertical-align: middle;"> MLX Knife
<p align="center">
<img src="mlxk-demo.gif" alt="MLX Knife Demo" width="1000">
<img src="https://github.com/mzau/mlx-knife/raw/main/mlxk-demo.gif" alt="MLX Knife Demo" width="1000">
</p>
A lightweight, ollama-like CLI for managing and running MLX models on Apple Silicon. **Designed for personal, local use** - perfect for individual developers and researchers working with MLX models.
A lightweight, ollama-like CLI for managing and running MLX models on Apple Silicon. **CLI-only tool designed for personal, local use** - perfect for individual developers and researchers working with MLX models.
**Current Version**: 1.0-rc3 (August 2025)
> **Note**: MLX Knife is designed as a command-line interface tool only. While some internal functions are accessible via Python imports, only CLI usage is officially supported.
**Current Version**: 1.0.0 (August 2025)
[![GitHub Release](https://img.shields.io/github/v/release/mzau/mlx-knife)](https://github.com/mzau/mlx-knife/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -48,6 +50,16 @@ A lightweight, ollama-like CLI for managing and running MLX models on Apple Sili
## Installation
### Via PyPI (Recommended)
```bash
pip install mlx-knife
```
### Via GitHub (Development)
```bash
pip install git+https://github.com/mzau/mlx-knife.git
```
### Requirements
- macOS with Apple Silicon (M1/M2/M3)
- Python 3.9+ (native macOS version or newer)