Utiliser MLX Harness.

1Installer MLX Harness

Il vous faut un Mac avec Apple Silicon sous macOS 14.5 ou ultérieur. Le moteur d’inférence est intégré à l’app, il n’y a donc rien d’autre à installer : téléchargez-la, placez MLX Harness dans Applications et ouvrez-la.

MLX Harness est une version modifiée de vMLX de JANGQ AI, publiée sous licence Apache 2.0. Le moteur est celui de vMLX, inchangé ; MLX Harness modifie l’app autour et ajoute la page Network.

2Choisir et télécharger un modèle

Les modèles viennent de Hugging Face, pour la plupart au format MLX de l’organisation mlx-community. Avant de télécharger, vérifiez ce qui tient : Compare montre quels modèles tiennent dans la mémoire de votre Mac et, à peu près, à quelle vitesse chacun écrit.

1. Ouvrez Models et choisissez Find & download. Cherchez, et triez par téléchargements, tendance, likes, mise à jour récente ou taille du modèle ; la recherche liste des modèles MLX.
2. Cliquez sur un modèle pour lire son README, puis téléchargez-le. Les téléchargements tournent en arrière-plan, et Downloads affiche leur progression.
3. Pour les modèles à accès restreint comme Llama, ajoutez d’abord votre token Hugging Face dans le champ HF Token: et acceptez la licence du modèle sur huggingface.co.
4. Library & tools liste les modèles présents sur votre Mac. Inspect Model affiche les métadonnées d’un modèle, Diagnose Model lance des vérifications et Convert Model transforme un modèle Hugging Face en modèle MLX quantifié : Balanced (4-bit), Quality (8-bit) ou Compact (3-bit).

Les téléchargements vont dans votre dossier de cache Hugging Face, sauf si vous en choisissez un autre sous Download to:. MLX Harness trouve aussi les modèles déjà présents dans ce cache, dans ~/.mlxstudio/models et dans les dossiers que vous ajoutez sous Directories.

3Chat et images

Chat et raisonnement

1. Ouvrez Chat & Images, choisissez un modèle dans le menu des modèles de la barre du chat, ou Add local model. Il démarre avec les réglages par défaut détectés ; les options avancées restent dans Servers & API.
2. Tapez un message. Les modèles de raisonnement affichent leur réflexion dans un encadré séparé. Enable Thinking, dans les réglages du chat, la règle sur Auto, On ou Off, et Reasoning Effort en fixe la profondeur pour les modèles qui le permettent.
3. Les modèles de vision acceptent des images : déposez un fichier dans le chat ou utilisez le bouton de pièce jointe. Les fichiers vidéo, audio et texte fonctionnent avec les modèles qui les acceptent.
4. Les conversations sont enregistrées dans la barre latérale et peuvent être recherchées. Les réglages sont enregistrés par modèle.

Vous pouvez aussi discuter avec un modèle hébergé ailleurs : Connect remote endpoint accepte l’adresse de n’importe quelle API compatible OpenAI. C’est seulement dans ce cas que vos prompts quittent le Mac.

Générer et retoucher des images

Dans Chat & Images, choisissez Image. Les modèles d’image passent par mflux, et le serveur d’images charge un modèle depuis un dossier de votre Mac : Find mflux models ouvre la recherche d’images dans Models, puis Load selected folder le lance.

Certains modèles d’image, comme Flux Dev, sont à accès restreint sur Hugging Face et demandent votre token et une licence acceptée avant le téléchargement.

4Agents et outils

MLX Harness peut laisser un modèle agir sur votre Mac. Dans les réglages du chat, activez Enable Built-in Coding Tools et choisissez un Working Directory : chaque opération sur des fichiers et chaque commande s’exécutent à l’intérieur. Activez ou désactivez ensuite les catégories d’outils :

Max Tool Iterations limite le nombre de tours d’appels d’outils pour un même message (10 par défaut). Les outils shell et fichiers agissent sur de vrais fichiers : faites pointer le dossier de travail vers un projet, pas vers votre dossier personnel, et utilisez un modèle à qui vous faites confiance pour cela.

5L’utiliser depuis d’autres apps : l’API locale

Chaque modèle que vous lancez est servi sur votre Mac. L’API Gateway à l’adresse http://localhost:8080 achemine chaque requête vers le bon modèle d’après le nom indiqué dans la requête, et démarre un modèle arrêté quand on le demande. Chaque modèle a aussi son propre port, à partir de 8000. Par défaut, seul votre Mac peut y accéder ; activer LAN les ouvre à votre réseau.

Derrière l’API, le moteur met en cache ce qu’il a déjà lu. Avec Continuous Batching activé, le Prefix Cache permet à une longue conversation ou aux instructions répétées d’un agent de code d’économiser du travail au tour suivant, KV Cache Quantization réduit ce cache et Disk Cache (Persistent) le conserve sur le SSD. Ces options se trouvent dans les réglages serveur de chaque modèle.

Une requête au format OpenAI, avec le nom de modèle affiché sur la page API :

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR-MODEL",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

N’importe quel SDK OpenAI fonctionne avec base_url réglé sur http://localhost:8080/v1 ; la clé peut être n’importe quel texte, sauf si vous en définissez une pour la session. Pour les agents de code, Coding Tool Integration configure Claude Code, Codex CLI, OpenCode, OpenClaw et Hermes Agent avec Auto-Configure, ou affiche un Manual Setup. Pour Claude Code, il s’agit de fusionner ceci dans ~/.claude/settings.json :

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:8080",
    "ANTHROPIC_MODEL": "YOUR-MODEL",
    "ANTHROPIC_API_KEY": "mlxstudio"
  }
}

6La page Network, et MLX Node

Network affiche MLX Network en direct depuis mlx.app : Mac en ligne et au travail, tokens par seconde, tokens d’IA du jour et pays. Elle vérifie si MLX Node est installé sur ce Mac et en cours d’exécution, et l’ouvre ou renvoie vers le téléchargement. Saisissez le nom de votre portefeuille sous Your wallet et appuyez sur Show pour voir ses MLX minés augmenter ; le nom reste uniquement sur ce Mac.

MLX Harness lui-même ne mine jamais. Il exécute des modèles pour vous. MLX Node est l’app distincte de la barre des menus qui prête le temps libre de votre Mac à MLX Network et gagne des jetons MLX : jusqu’à 1 MLX par jour sur une place gratuite, bloqués 30 jours. Si vous utilisez les deux, ils partagent la même mémoire et le même GPU ; la limite Memory MLX may use de MLX Node et le Start et Stop manuels l’empêchent de vous gêner. Les jetons MLX peuvent perdre de la valeur ; lisez les risques.

7Questions

MLX Harness est-il gratuit ?

Oui. Il est gratuit et sous licence Apache 2.0, comme vMLX, le projet sur lequel il est construit.

Quand pourrai-je télécharger MLX Harness ?

Dès maintenant. C’est un téléchargement gratuit sur harness.mlx.app et mlx.app/download, pour les Mac Apple Silicon sous macOS 14.5 ou ultérieur. Le code source est sur GitHub : github.com/MLXapp/studio.

Sur quels Mac MLX Harness fonctionne-t-il ?

Les Mac avec Apple Silicon (M1 ou ultérieur) sous macOS 14.5 ou ultérieur. La mémoire de votre Mac détermine quels modèles tiennent ; Compare sur mlx.app vous les montre.

MLX Harness envoie-t-il mes prompts quelque part ?

Non. Les modèles locaux tournent sur votre Mac, et l’API n’écoute que sur votre Mac, sauf si vous activez LAN. Les prompts ne quittent le Mac que si vous connectez un endpoint distant.

MLX Harness gagne-t-il des jetons MLX ?

Non. MLX Harness exécute des modèles pour vous et ne lit que des chiffres publics du réseau. C’est MLX Node qui gagne des jetons MLX en échange de travail d’IA.