Release 2.0.4 stable - see CHANGELOG.md for details

README.md

@@ -4,9 +4,9 @@
   <img src="https://github.com/mzau/mlx-knife/raw/main/mlxk-demo.gif" alt="MLX Knife Demo" width="900">
 </p>
 
-**Current Version: 2.0.4-beta.10** (Stable: 2.0.3)
+**Current Version: 2.0.4** (Stable)
 
-[![GitHub Release](https://img.shields.io/badge/version-2.0.4--beta.10-blue.svg)](https://github.com/mzau/mlx-knife/releases)
+[![GitHub Release](https://img.shields.io/badge/version-2.0.4-blue.svg)](https://github.com/mzau/mlx-knife/releases)
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 [![Python 3.10-3.12](https://img.shields.io/badge/python-3.10--3.12-blue.svg)](https://www.python.org/downloads/)
 [![Apple Silicon](https://img.shields.io/badge/Apple%20Silicon-green.svg)](https://support.apple.com/en-us/HT211814)
@@ -17,10 +17,8 @@
 
 ## Features
 
-> **⚠️ Beta.9 Audio Bug:** If you installed `mlx-knife[audio]==2.0.4b9` from PyPI, audio transcription fails with "Processor not found". Upgrade to beta.10: `pip install mlx-knife[all]==2.0.4b10`
-
-### What's New in 2.0.4 (Coming Soon - Currently Beta)
-- **Audio Transcription (STT)** - Whisper speech-to-text (`--audio` flag, `pip install mlx-knife[audio]`)
+### What's New in 2.0.4
+- **Audio Transcription (STT)** - Whisper speech-to-text (`--audio` flag)
 - **Vision Models with EXIF Metadata** - Image analysis + automatic GPS/date/camera extraction visible to the model
 - **Unix Pipe Integration** - Chain models without temp files (`vision → text` workflows)
 - **Local Development Workflow** - Clone → Repair → Test models without HuggingFace round-trips
@@ -79,42 +77,33 @@ This license applies **only** to the `mlx-knife` code and **does not extend** to
 ### Python Compatibility
 
 ✅ **Python 3.10 - 3.12** - Full support (Text + Vision + Audio)
-❌ **Python 3.9** - Not supported (MLX 0.30+ requires 3.10+)
+❌ **Python 3.9** - Use version 2.0.3 (text + cache management only)
 ❌ **Python 3.13+** - Not supported (miniaudio lacks pre-built wheels)
 
-**Note:** Vision/Audio features require Python 3.10+. Recommended: **Python 3.10 or 3.11** for best compatibility.
+**Recommended:** Python 3.10 or 3.11 for best compatibility.
 
 
 
 ## Installation
 
-### 1. PyPI Stable (2.0.3 - Text models only)
+### 1. PyPI (Recommended)
 
 ```bash
 pip install mlx-knife
-mlxk --version  # → mlxk 2.0.3
-```
-
-**Requirements:** macOS Apple Silicon, Python 3.9-3.12
-
-### 2. PyPI Beta (2.0.4-beta.10 - Text + Vision + Audio)
-
-```bash
-pip install mlx-knife[all]==2.0.4b10
-mlxk --version  # → mlxk 2.0.4b10
+mlxk --version  # → mlxk 2.0.4
 ```
 
 **Requirements:** macOS Apple Silicon, Python 3.10-3.12
-**Features:** Audio STT (Whisper), Vision with EXIF metadata, full tiktoken workaround
+**Includes:** Text, Vision, Audio (Whisper STT), EXIF metadata, Unix pipes
 
-### 3. Developer Installation
+### 2. Developer Installation
 
 ```bash
 git clone https://github.com/mzau/mlx-knife.git
 cd mlx-knife
-pip install -e ".[all,dev,test]"
+pip install -e ".[dev,test]"
 
-mlxk --version  # → mlxk 2.0.4b10
+mlxk --version  # → mlxk 2.0.4
 pytest -v
 ```
 
@@ -285,8 +274,7 @@ Image analysis via the `--image` flag (CLI and server). Requires Python 3.10+.
 #### Requirements
 
 - **Python 3.10+** (mlx-vlm dependency)
-- **Installation:** `pip install mlx-knife[vision]`
-- **Backend:** mlx-vlm 0.3.10 (auto-installed from PyPI)
+- **Backend:** mlx-vlm 0.3.10 (included in base install)
 
 #### Usage
 
@@ -424,7 +412,7 @@ curl http://localhost:8000/v1/chat/completions -H "Content-Type: application/jso
 
 **⚠️ Important:** Vision support relies on mlx-vlm (upstream), which has known stability issues. While `mlxk health` verifies file integrity, **runtime failures may occur** with certain model architectures due to upstream bugs.
 
-**✅ Tested & Working Models** (mlx-knife v2.0.4-beta.6):
+**✅ Tested & Working Models** (mlx-knife v2.0.4):
 
 | Model | Size | Notes |
 |-------|------|-------|
@@ -452,14 +440,13 @@ mlxk convert <model> <output> --repair-index
 
 ### Audio Transcription (Speech-to-Text)
 
-> **🎙️ New in beta.9/10:** Professional STT via dedicated Whisper models (mlx-audio backend). Beta.10 fixes PyPI install (no Git workaround needed). Backward compatible with Gemma-3n multimodal audio (mlx-vlm).
+> **🎙️ Audio Transcription:** Speech-to-text via Whisper models (mlx-audio backend). Works out-of-the-box with PyPI install. Backward compatible with Gemma-3n multimodal audio (mlx-vlm).
 
 **Requirements:**
-- **Python 3.10+** (mlx-audio dependency)
-- **Installation:** `pip install mlx-knife[audio]` (tiktoken workaround bundled)
+- **Python 3.10+** (mlx-audio dependency, included in base install)
 - **No system dependencies:** MP3/WAV decoding via embedded libsndfile (no ffmpeg or Homebrew required)
 
-**✅ Recommended Models** (mlx-knife v2.0.4-beta.10):
+**✅ Recommended Models** (mlx-knife v2.0.4):
 
 | Model | Backend | Size | Duration | Notes |
 |-------|---------|------|----------|-------|
@@ -1240,7 +1227,7 @@ Apache License 2.0 — see `LICENSE` (root) and `mlxk2/NOTICE`.
 
 <p align="center">
   <b>Made with ❤️ by The BROKE team <img src="broke-logo.png" alt="BROKE Logo" width="30" align="middle"></b><br>
-  <i>Version 2.0.4-beta.10 | February 2026</i><br>
+  <i>Version 2.0.4 | February 2026</i><br>
   <a href="https://github.com/mzau/broke-nchat">💬 Web UI: nChat - lightweight chat interface</a> •
   <a href="https://github.com/mzau/broke-cluster">🔮 Multi-node: BROKE Cluster</a>
 </p>