Cómo usar MLX Harness.

1Instala MLX Harness

Necesitas una Mac con Apple Silicon y macOS 14.5 o posterior. El motor de inferencia viene dentro de la app, así que no hay nada más que instalar: descárgala, mueve MLX Harness a Aplicaciones y ábrela.

MLX Harness es una versión modificada de vMLX de JANGQ AI, publicada con la licencia Apache 2.0. El motor es el de vMLX, sin cambios; MLX Harness cambia la app que lo rodea y añade la página Network.

2Elige y descarga un modelo

Los modelos vienen de Hugging Face, la mayoría en formato MLX de la organización mlx-community. Antes de descargar, comprueba qué cabe: Compare muestra qué modelos caben en la memoria de tu Mac y, aproximadamente, a qué velocidad escribe cada uno.

1. Abre Models y elige Find & download. Busca y ordena por descargas, tendencia, me gusta, actualización reciente o tamaño del modelo; la búsqueda muestra modelos MLX.
2. Haz clic en un modelo para leer su README y luego descárgalo. Las descargas se hacen en segundo plano, y Downloads muestra su progreso.
3. Para modelos con acceso restringido, como Llama, añade primero tu token de Hugging Face en el campo HF Token: y acepta la licencia del modelo en huggingface.co.
4. Library & tools muestra los modelos de tu Mac. Inspect Model muestra los metadatos de un modelo, Diagnose Model hace comprobaciones de estado y Convert Model convierte un modelo de Hugging Face en uno MLX cuantizado: Balanced (4-bit), Quality (8-bit) o Compact (3-bit).

Las descargas van a tu carpeta de caché de Hugging Face, salvo que elijas otra en Download to:. MLX Harness también encuentra los modelos que ya están en esa caché, en ~/.mlxstudio/models y en las carpetas que añadas en Directories.

3Chat e imágenes

Chat y razonamiento

1. Abre Chat & Images y elige un modelo en el menú de modelos de la barra del chat, o Add local model. Arranca con los valores predeterminados detectados; las opciones avanzadas están en Servers & API.
2. Escribe un mensaje. Los modelos de razonamiento muestran su razonamiento en un cuadro aparte. Enable Thinking, en los ajustes del chat, lo pone en Auto, On u Off, y Reasoning Effort fija su profundidad en los modelos que lo admiten.
3. Los modelos de visión aceptan imágenes: suelta un archivo en el chat o usa el botón de adjuntar. Los archivos de video, audio y texto funcionan con los modelos que los aceptan.
4. Los chats se guardan en la barra lateral y se pueden buscar. Los ajustes se guardan por modelo.

También puedes chatear con un modelo que esté en otro lugar: Connect remote endpoint acepta la dirección de cualquier API compatible con OpenAI. Solo entonces tus prompts salen de la Mac.

Genera y edita imágenes

En Chat & Images, elige Image. Los modelos de imagen funcionan con mflux, y el servidor de imágenes carga un modelo desde una carpeta de tu Mac: Find mflux models abre la búsqueda de imágenes en Models, y luego Load selected folder lo inicia.

Algunos modelos de imagen, como Flux Dev, tienen acceso restringido en Hugging Face y necesitan tu token y una licencia aceptada antes de descargarse.

4Agentes y herramientas

MLX Harness puede dejar que un modelo actúe en tu Mac. En los ajustes del chat, activa Enable Built-in Coding Tools y elige un Working Directory: cada operación con archivos y cada comando se ejecutan dentro de él. Luego activa o desactiva las categorías de herramientas:

Max Tool Iterations limita cuántas rondas de llamadas a herramientas puede hacer un mensaje (10 por defecto). Las herramientas de shell y de archivos actúan sobre archivos reales, así que apunta el directorio de trabajo a un proyecto, no a tu carpeta personal, y usa un modelo en el que confíes para ello.

5Úsalo desde otras apps: la API local

Cada modelo que inicias se sirve en tu Mac. El API Gateway en http://localhost:8080 envía cada solicitud al modelo correcto según el nombre que lleva la solicitud, e inicia un modelo detenido cuando se lo piden. Cada modelo tiene además su propio puerto, a partir del 8000. De forma predeterminada solo tu Mac puede acceder a ellos; activar LAN los abre a tu red.

Detrás de la API, el motor guarda en caché lo que ya ha leído. Con Continuous Batching activado, la Prefix Cache permite que un chat largo o las instrucciones repetidas de un agente de programación se ahorren trabajo en el siguiente turno, KV Cache Quantization reduce esa caché y Disk Cache (Persistent) la guarda en el SSD. Están en los ajustes de servidor de cada modelo.

Una solicitud en formato OpenAI, con el nombre de modelo que muestra la página API:

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

Cualquier SDK de OpenAI funciona con base_url en http://localhost:8080/v1; la clave puede ser cualquier texto salvo que fijes una en la sesión. Para agentes de programación, Coding Tool Integration configura Claude Code, Codex CLI, OpenCode, OpenClaw y Hermes Agent con Auto-Configure, o muestra un Manual Setup. Para Claude Code, eso significa fusionar esto en ~/.claude/settings.json:

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

6La página Network y MLX Node

Network muestra MLX Network en vivo desde mlx.app: Mac en línea y trabajando, tokens por segundo, tokens de IA de hoy y países. Comprueba si MLX Node está instalado en esta Mac y en marcha, y lo abre o enlaza a la descarga. Escribe el nombre de tu billetera en Your wallet y pulsa Show para ver cómo sube su MLX minado; el nombre se guarda solo en esta Mac.

MLX Harness por sí mismo nunca mina. Ejecuta modelos para ti. MLX Node es la app de la barra de menús, aparte, que presta el tiempo libre de tu Mac a MLX Network y gana tokens MLX: hasta 1 MLX al día con una plaza gratuita, bloqueados 30 días. Si usas las dos, comparten la misma memoria y la misma GPU, así que el límite Memory MLX may use de MLX Node y el Start y Stop manuales evitan que te estorbe. Los tokens MLX pueden perder valor; lee los riesgos.

7Preguntas

¿MLX Harness es gratis?

Sí. Es gratuito y tiene licencia Apache 2.0, igual que vMLX, el proyecto en el que se basa.

¿Cuándo podré descargar MLX Harness?

Ya mismo. Es una descarga gratuita en harness.mlx.app y mlx.app/download, para Mac con Apple Silicon y macOS 14.5 o posterior. El código fuente está en GitHub, en github.com/MLXapp/studio.

¿En qué Mac funciona MLX Harness?

En Mac con Apple Silicon (M1 o posterior) y macOS 14.5 o posterior. La memoria de tu Mac decide qué modelos caben; Compare en mlx.app te lo muestra.

¿MLX Harness envía mis prompts a algún sitio?

No. Los modelos locales se ejecutan en tu Mac, y la API solo escucha en tu Mac salvo que actives LAN. Los prompts solo salen de la Mac si conectas un endpoint remoto.

¿MLX Harness gana tokens MLX?

No. MLX Harness ejecuta modelos para ti y solo lee cifras públicas de la red. MLX Node es la app que gana tokens MLX por trabajo de IA.