هل MLX Harness مجاني؟

نعم. إنه مجاني ومرخّص بموجب Apache License 2.0، مثل vMLX، المشروع الذي بُني عليه.

متى يمكنني تنزيل MLX Harness؟

الآن. التنزيل مجاني على harness.mlx.app و mlx.app/download، لأجهزة Mac بشرائح Apple Silicon ونظام macOS 14.5 أو أحدث. والشيفرة المصدرية على GitHub في github.com/MLXapp/studio.

على أي أجهزة Mac يعمل MLX Harness؟

أجهزة Mac بشريحة Apple Silicon (M1 أو أحدث) ونظام macOS 14.5 أو أحدث. ذاكرة جهازك تحدد النماذج التي تتسع؛ وتعرضها صفحة Compare على mlx.app.

هل يرسل MLX Harness موجّهاتي إلى أي مكان؟

لا. تعمل النماذج المحلية على جهازك، ولا تستمع واجهة API إلا على جهازك ما لم تفعّل LAN. ولا تغادر الموجّهات الجهاز إلا إذا ربطت نقطة اتصال بعيدة.

هل يكسب MLX Harness رموز MLX؟

لا. يشغّل MLX Harness النماذج لك ولا يقرأ إلا أرقام الشبكة العلنية. أما MLX Node فهو التطبيق الذي يكسب رموز MLX مقابل عمل الذكاء الاصطناعي.

كيف تستخدم MLX Harness: شغّل نماذج الذكاء الاصطناعي محليًا على ماك

باختصار

يشغّل MLX Harness نماذج الذكاء الاصطناعي على جهاز Mac. تبقى الموجّهات والإجابات على الجهاز ما لم تربط بنفسك نقطة اتصال بعيدة.
مبني على vMLX من JANGQ AI ومرخّص بموجب Apache 2.0. نزّله من harness.mlx.app أو mlx.app/download.
أربع صفحات: Chat & Images و Servers & API و Models و Network، و Preferences في أسفل الشريط الجانبي.
كل نموذج قيد التشغيل يُقدَّم عبر واجهة API محلية على localhost:8080 بصيغ OpenAI و Anthropic و Ollama، لتستخدمه التطبيقات ووكلاء البرمجة.

1ثبّت MLX Harness

نزّل MLX Harness من harness.mlx.app. إنه موقّع وموثّق (notarized) من Apple، ويضم MLX Node في داخله، ويخبرك داخل التطبيق عند صدور إصدار جديد.

تحتاج إلى Mac بشريحة Apple Silicon ونظام macOS 14.5 أو أحدث. محرك الاستدلال مدمج في التطبيق، فلا شيء آخر لتثبيته: نزّله، وانقل MLX Harness إلى مجلد التطبيقات وافتحه.

MLX Harness نسخة معدّلة من vMLX من JANGQ AI، صادرة بموجب Apache License 2.0. المحرك في الأساس هو محرك vMLX دون تغيير؛ ويغيّر MLX Harness التطبيق من حوله ويضيف صفحة Network.

2اختر نموذجًا ونزّله

تأتي النماذج من Hugging Face، ومعظمها بصيغة MLX من مؤسسة mlx-community. قبل التنزيل، تحقق مما يتسع: تعرض صفحة Compare النماذج التي تتسع لها ذاكرة جهازك وسرعة كتابة كل منها تقريبًا.

افتح Models واختر Find & download. ابحث، ورتّب حسب التنزيلات أو الرائج أو الإعجابات أو آخر تحديث أو حجم النموذج؛ يعرض البحث نماذج MLX.
انقر نموذجًا لتقرأ ملف README الخاص به، ثم نزّله. تجري التنزيلات في الخلفية، وتعرض Downloads تقدّمها.
للنماذج المقيّدة مثل Llama، أضف رمز Hugging Face المميز (token) في حقل HF Token: أولًا، واقبل ترخيص النموذج على huggingface.co.
تعرض Library & tools النماذج الموجودة على جهازك. يعرض Inspect Model البيانات الوصفية للنموذج، ويجري Diagnose Model فحوصات سلامة، ويحوّل Convert Model نموذجًا من Hugging Face إلى نموذج MLX مُكمَّم: Balanced (4-bit) أو Quality (8-bit) أو Compact (3-bit).

تذهب التنزيلات إلى مجلد ذاكرة Hugging Face المؤقتة ما لم تختر مجلدًا آخر تحت Download to:. ويجد MLX Harness أيضًا النماذج الموجودة مسبقًا في تلك الذاكرة المؤقتة، وفي ~/.mlxstudio/models، وفي المجلدات التي تضيفها تحت Directories.

3الدردشة والصور

الدردشة والتفكير

افتح Chat & Images، واختر نموذجًا من قائمة النماذج في شريط أدوات الدردشة، أو Add local model. يبدأ بالإعدادات الافتراضية المكتشفة؛ وتبقى الخيارات المتقدمة في Servers & API.
اكتب رسالة. تعرض نماذج التفكير تفكيرها في مربع منفصل. يضبطه Enable Thinking في إعدادات الدردشة على Auto أو On أو Off، ويحدد Reasoning Effort عمقه في النماذج التي تدعمه.
تقبل نماذج الرؤية الصور: أفلت ملفًا في الدردشة أو استخدم زر الإرفاق. وتعمل ملفات الفيديو والصوت والنصوص مع النماذج التي تقبلها.
تُحفظ المحادثات في الشريط الجانبي ويمكن البحث فيها. وتُحفظ الإعدادات لكل نموذج.

يمكنك أيضًا الدردشة مع نموذج يعمل في مكان آخر: يقبل Connect remote endpoint عنوان أي واجهة API متوافقة مع OpenAI. وعندها فقط تغادر موجّهاتك جهاز Mac.

توليد الصور وتحريرها

في Chat & Images، اختر Image. تعمل نماذج الصور عبر mflux، ويحمّل خادم الصور نموذجًا من مجلد على جهازك: يفتح Find mflux models بحث الصور في Models، ثم يشغّله Load selected folder.

الاستخدام	عائلات النماذج
التوليد	Flux Schnell، Flux Dev، Z-Image Turbo، FLUX.2 Klein 4B و 9B، Qwen Image، Qwen Image 2.1، FIBO، Ideogram 4
التحرير	Qwen Image Edit، Qwen Image 2.1، Flux Kontext، FLUX.2 Klein Edit، Flux Fill (رسم داخل منطقة بقناع ترسمه بنفسك)
التكبير	SeedVR2 3B

العائلات التي يستطيع MLX Harness تحميلها. تختلف الذاكرة حسب النموذج والدقة؛ ويقترح التطبيق Flux Schnell أو Klein 4B بدقة 4 بت لجهاز Mac بذاكرة 16 GB، ودقة 8 بت أو الدقة الكاملة لنماذج التحرير.

بعض نماذج الصور، مثل Flux Dev، مقيّدة على Hugging Face وتحتاج إلى رمزك المميز وقبول الترخيص قبل تنزيلها.

4الوكلاء والأدوات

يستطيع MLX Harness أن يدع النموذج يتصرف على جهازك. في إعدادات الدردشة، فعّل Enable Built-in Coding Tools واختر Working Directory: تجري كل عملية على الملفات وكل أمر داخله. ثم فعّل فئات الأدوات أو عطّلها:

الفئة	الأدوات المدمجة
File I/O	`read_file`, `write_file`, `edit_file`, `patch_file`, `batch_edit`, `insert_text`, `replace_lines`, `apply_regex`, `copy_file`, `move_file`, `delete_file`, `create_directory`, `list_directory`, `read_image`, `read_video`
Search	`search_files`, `find_files`, `file_info`, `get_tree`, `diff_files`, `get_diagnostics`
Shell	`run_command`, `spawn_process`, `get_process_output`, `run_applescript`
Web Search	`ddg_search`: مجاني، يجرّب DuckDuckGo ثم Mojeek
Brave Search	`web_search`، مع مفتاح Brave Search API
URL Fetch	`fetch_url`
Git	`git`: status و diff و log و blame و commit و branch و stash
Utilities	`count_tokens`, `clipboard_read`, `clipboard_write`, `get_current_datetime`؛ و`ask_user` مفعّل دائمًا

من قائمة الأدوات المدمجة في MLX Harness. تضيف خوادم MCP أدواتها الخاصة بجانب هذه.

يحدد Max Tool Iterations عدد جولات استدعاء الأدوات التي يمكن أن تستغرقها رسالة واحدة (10 افتراضيًا). أدوات الطرفية والملفات تعمل على ملفات حقيقية، فوجّه مجلد العمل إلى مشروع لا إلى مجلد المنزل، واستخدم نموذجًا تثق به في ذلك.

5استخدمه من تطبيقات أخرى: واجهة API المحلية

كل نموذج تشغّله يُقدَّم على جهازك. توجّه API Gateway على http://localhost:8080 كل طلب إلى النموذج الصحيح حسب الاسم الوارد في الطلب، وتشغّل نموذجًا متوقفًا حين يُطلب. ولكل نموذج أيضًا منفذ خاص به، من 8000 فما فوق. افتراضيًا لا يصل إليها إلا جهازك؛ وتفعيل LAN يفتحها لشبكتك.

الصيغة	نقاط الاتصال
OpenAI	`/v1/chat/completions`, `/v1/responses`, `/v1/completions`, `/v1/models`, `/v1/embeddings`
Anthropic	`/v1/messages`
Ollama	`/api/chat`, `/api/generate`, `/api/tags`, `/api/show`, `/api/embed`
الصور	`/v1/images/generations`, `/v1/images/edits`
الصوت	`/v1/audio/transcriptions` (Whisper)، `/v1/audio/speech` (Kokoro)

يعرض Servers & API → API كل نقاط الاتصال للنماذج التي تشغّلها، مع مقتطفات جاهزة للنسخ بـ curl و Python و JavaScript.

خلف واجهة API، يخزّن المحرك مؤقتًا ما قرأه بالفعل. مع تفعيل Continuous Batching، يتيح Prefix Cache لمحادثة طويلة أو للتعليمات المتكررة لوكيل برمجة تخطي جزء من العمل في الدور التالي، ويقلّص KV Cache Quantization هذه الذاكرة المؤقتة، ويحفظها Disk Cache (Persistent) على SSD. تجد هذه الخيارات في إعدادات الخادم لكل نموذج.

طلب بصيغة OpenAI، باسم النموذج الذي تعرضه صفحة API:

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

تعمل أي حزمة OpenAI SDK مع ضبط base_url على http://localhost:8080/v1؛ ويمكن أن يكون المفتاح أي نص ما لم تحدد مفتاحًا للجلسة. ولوكلاء البرمجة، يُعدّ Coding Tool Integration كلًّا من Claude Code و Codex CLI و OpenCode و OpenClaw و Hermes Agent بزر Auto-Configure، أو يعرض Manual Setup. بالنسبة إلى Claude Code، يعني ذلك دمج ما يلي في ~/.claude/settings.json:

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

6صفحة Network، و MLX Node

تعرض Network شبكة MLX Network حيةً من mlx.app: أجهزة Mac المتصلة والعاملة، والتوكنات في الثانية، وتوكنات الذكاء الاصطناعي اليوم، والبلدان. وتتحقق مما إذا كان MLX Node مثبتًا على هذا الجهاز ويعمل، فتفتحه أو تقدّم رابط تنزيله. اكتب اسم محفظتك تحت Your wallet واضغط Show لتتابع MLX المُعدَّن فيها وهو يزداد؛ ويُحفظ الاسم على هذا الجهاز فقط.

لا يعدّن MLX Harness نفسه أبدًا، بل يشغّل النماذج لك. أما MLX Node فهو تطبيق شريط القائمة المنفصل الذي يعير وقت خمول جهازك لشبكة MLX Network ويكسب رموز MLX: حتى 1 MLX يوميًا على مقعد مجاني، مقفلة لمدة 30 يومًا. إذا استخدمت الاثنين، فهما يتقاسمان الذاكرة ووحدة GPU نفسيهما، لذا يُبقي حد Memory MLX may use في MLX Node والتشغيل والإيقاف اليدويان التطبيقَ بعيدًا عن طريقك. قد تفقد رموز MLX قيمتها؛ اقرأ المخاطر.

7أسئلة

هل MLX Harness مجاني؟: نعم. إنه مجاني ومرخّص بموجب Apache License 2.0، مثل vMLX، المشروع الذي بُني عليه.
متى يمكنني تنزيل MLX Harness؟: الآن. التنزيل مجاني على harness.mlx.app و mlx.app/download، لأجهزة Mac بشرائح Apple Silicon ونظام macOS 14.5 أو أحدث. والشيفرة المصدرية على GitHub في github.com/MLXapp/studio.
على أي أجهزة Mac يعمل MLX Harness؟: أجهزة Mac بشريحة Apple Silicon (M1 أو أحدث) ونظام macOS 14.5 أو أحدث. ذاكرة جهازك تحدد النماذج التي تتسع؛ وتعرضها صفحة Compare على mlx.app.
هل يرسل MLX Harness موجّهاتي إلى أي مكان؟: لا. تعمل النماذج المحلية على جهازك، ولا تستمع واجهة API إلا على جهازك ما لم تفعّل LAN. ولا تغادر الموجّهات الجهاز إلا إذا ربطت نقطة اتصال بعيدة.
هل يكسب MLX Harness رموز MLX؟: لا. يشغّل MLX Harness النماذج لك ولا يقرأ إلا أرقام الشبكة العلنية. أما MLX Node فهو التطبيق الذي يكسب رموز MLX مقابل عمل الذكاء الاصطناعي.

المصادر

vMLXgithub.com
Hugging Facehuggingface.co
mlx-communityhuggingface.co
mfluxgithub.com

كيف تستخدم MLX Harness.