ur-dad-matt commited on
Commit
a2ab338
Β·
verified Β·
1 Parent(s): 63d30c6

docs(card): SEO + cross-link refresh (HF-DISCOVERABILITY-001)

Browse files
Files changed (1) hide show
  1. README.md +16 -60
README.md CHANGED
@@ -72,77 +72,33 @@ widget:
72
  - role: user
73
  content: Name three reasons to run a local LLM.
74
  ---
 
75
 
76
- # Phi-4-mini-instruct β€” MLX 4-bit
77
 
78
- 4-bit MLX conversion of [Phi-4-mini-instruct](https://huggingface.co/microsoft/Phi-4-mini-instruct) for Apple Silicon. Runs natively on
79
- M1, M2, M3, and M4 Macs via `mlx_lm`. Faithful port of the upstream weights β€” no
80
- fine-tuning, no merge.
81
 
82
- ## Quick facts
83
-
84
- - **Upstream base:** [Phi-4-mini-instruct](https://huggingface.co/microsoft/Phi-4-mini-instruct)
85
- - **Format:** MLX 4-bit (`mlx_lm.convert --q-bits 4 --q-group-size 64`)
86
- - **License:** `mit`
87
- - **Use case:** fast
88
- - **Runtime:** mlx-lm, LM Studio, Jan, Outlier desktop app
89
- - **Publisher:** Outlier-Ai (solo, Mac-native AI platform)
90
-
91
- ## Quickstart (mlx-lm)
92
 
93
  ```bash
94
- pip install -U mlx-lm
95
- python -m mlx_lm.generate \
96
- --model Outlier-Ai/Phi-4-mini-instruct-MLX-4bit \
97
- --prompt "Write a haiku about compilers." \
98
- --max-tokens 256
99
  ```
100
 
101
- ## Quickstart (LM Studio)
102
-
103
- Search for `Outlier-Ai/Phi-4-mini-instruct-MLX-4bit`, then Load and chat.
104
-
105
- ## Quickstart (Outlier desktop app)
106
-
107
- One-click install from [outlier.host](https://outlier.host). Listed in the library
108
- picker under `fast`.
109
-
110
- ## Why this repo exists
111
-
112
- This is a canonically-named twin of [Outlier-Ai/Outlier-Phi4-mini-MLX-4bit](https://huggingface.co/Outlier-Ai/Outlier-Phi4-mini-MLX-4bit).
113
- Same weights, same quant, different name. The branded repo carries the Outlier
114
- identity; this one carries the upstream identity so it's findable via searches
115
- like "phi-4-mini-instruct 4bit mlx". Use whichever path you came across β€” both
116
- point to the same files.
117
-
118
- ## Provenance
119
-
120
- - Converted via `mlx_lm.convert --q-bits 4 --q-group-size 64`
121
- - Source: [Phi-4-mini-instruct](https://huggingface.co/microsoft/Phi-4-mini-instruct)
122
- - Date produced: 2026-04-19 (Day 19)
123
- - Conversion factory: Outlier MEGA-INFINITE phase3
124
-
125
- ## Related
126
-
127
- - **Branded twin (same weights):** [Outlier-Ai/Outlier-Phi4-mini-MLX-4bit](https://huggingface.co/Outlier-Ai/Outlier-Phi4-mini-MLX-4bit)
128
- - **Outlier org on HuggingFace:** [Outlier-Ai](https://huggingface.co/Outlier-Ai)
129
- - **Desktop app:** [outlier.host](https://outlier.host)
130
- - **Founders lifetime ($200, 500-seat cap):** [buy.polar.sh](https://buy.polar.sh/polar_cl_mJfYZsEpEMDcYrgxzvTdnahSeSQNq1UYLqV0l08CUhW)
131
- - **Discord:** [discord.gg/Hapennmdn9](https://discord.gg/Hapennmdn9)
132
 
133
- ## Collections
134
 
135
- - **Outlier for Apple Silicon (MLX):** [huggingface.co/collections/Outlier-Ai/outlier-consumer-edition-69e2fb4a0df119ea1747275e](https://huggingface.co/collections/Outlier-Ai/outlier-consumer-edition-69e2fb4a0df119ea1747275e)
136
- - **Outlier Research MoE:** [huggingface.co/collections/Outlier-Ai/outlier-research-69e2fb3a71984614b3c7a279](https://huggingface.co/collections/Outlier-Ai/outlier-research-69e2fb3a71984614b3c7a279)
137
- - **Outlier Server V3.2:** [huggingface.co/collections/Outlier-Ai/outlier-server-v32-69e2fb4b71984614b3c7a4a3](https://huggingface.co/collections/Outlier-Ai/outlier-server-v32-69e2fb4b71984614b3c7a4a3)
138
 
139
- ## Attribution
140
 
141
- Base model by the upstream author (see [Phi-4-mini-instruct](https://huggingface.co/microsoft/Phi-4-mini-instruct)). Outlier contributes
142
- the MLX 4-bit conversion and desktop-app packaging. Capability credit for the base
143
- belongs entirely to upstream.
 
 
144
 
145
  ## License
146
 
147
- Redistributed under the upstream license: `mit`. Respect the terms of
148
- [Phi-4-mini-instruct](https://huggingface.co/microsoft/Phi-4-mini-instruct) when using this conversion.
 
72
  - role: user
73
  content: Name three reasons to run a local LLM.
74
  ---
75
+ > **Run this on your Mac with [Outlier](https://outlier.host/?utm_source=hf&utm_medium=modelcard&utm_campaign=phi_4_mini_instruct_mlx_4bit)** β€” a free macOS app for local MLX inference.
76
 
77
+ # Phi-4-mini-instruct (MLX 4-bit)
78
 
79
+ MLX 4-bit conversion of [`microsoft/Phi-4-mini-instruct`](https://huggingface.co/microsoft/Phi-4-mini-instruct). License and base-model fields inherit from the original β€” see YAML frontmatter above.
 
 
80
 
81
+ ## Load with mlx-lm
 
 
 
 
 
 
 
 
 
82
 
83
  ```bash
84
+ pip install mlx-lm
85
+ python -m mlx_lm.generate --model Outlier-Ai/Phi-4-mini-instruct-MLX-4bit --prompt "Hello" --max-tokens 256
 
 
 
86
  ```
87
 
88
+ ## What is Outlier?
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
89
 
90
+ A free macOS app that runs MLX models locally β€” no cloud, no API keys, no usage caps.
91
 
92
+ ➑ **[outlier.host](https://outlier.host/?utm_source=hf&utm_medium=modelcard&utm_campaign=phi_4_mini_instruct_mlx_4bit)**
 
 
93
 
94
+ ## Other Outlier conversions
95
 
96
+ - [DeepSeek-R1-Distill-Qwen-7B (MLX 4-bit) β€” MLX 4-bit conversion (1,932 downloads)](https://huggingface.co/Outlier-Ai/DeepSeek-R1-Distill-Qwen-7B-MLX-4bit)
97
+ - [Qwen3-Coder-30B-A3B-Instruct (MLX 4-bit) β€” MLX 4-bit conversion (1,598 downloads)](https://huggingface.co/Outlier-Ai/Qwen3-Coder-30B-A3B-Instruct-MLX-4bit)
98
+ - [Qwen2.5-Coder-7B-Instruct (MLX 4-bit) β€” MLX 4-bit conversion (1,450 downloads)](https://huggingface.co/Outlier-Ai/Qwen2.5-Coder-7B-Instruct-MLX-4bit)
99
+ - [Outlier-Core-27B (MLX 4-bit) β€” MLX 4-bit conversion (55 downloads)](https://huggingface.co/Outlier-Ai/Outlier-Core-27B-MLX-4bit)
100
+ - [Outlier-Nano-4B (MLX 4-bit) β€” MLX 4-bit conversion (67 downloads)](https://huggingface.co/Outlier-Ai/Outlier-Nano-4B-MLX-4bit)
101
 
102
  ## License
103
 
104
+ Inherits from upstream (`mit`). See base model card.