تدبّر موديلات ومزوّدي وكلاء الذكاء الاصطناعي مع Magpie

شنو كيدير Magpie

Magpie كيوفّر بلاصة وحدة باش تشوف وتبدّل النماذج اللي كيستعملوها وكلاء الذكاء الاصطناعي المثبّتين فالحاسوب ديالك. متوفر كتطبيق فشريط القوائم، ونافذة عادية فسطح المكتب، وواجهة مستخدم فالطرفية، وأداة فسطّر الأوامر.

بلا ما تبدّل يدوياً فعدة ملفات JSON وTOML وYAML وملفات البيئة، تقدر تختار وكيل، وتختار حقلاً، وتعيّن ليه نموذجاً. Magpie كيبدّل غير الإعداد المعني، وكيحافظ على التعليقات والترتيب والمسافات البادئة فين ما كان ذلك ممكناً. عمليات الكتابة ديالو ذرّية.

Magpie كيتعرّف حالياً على Claude Code وCodex وGemini CLI وOpenCode وPi وGoose وCursor CLI وCopilot CLI وCrush. فالواجهة ديالو كيبانو غير الوكلاء المثبّتين أو المهيّئين.

الميزات الرئيسية

• واجهات متعددة: استعمل تطبيق سطح المكتب، أو لوحة شريط القوائم، أو واجهة الطرفية، أو سطر الأوامر العادي.
• تعديلات دقيقة على الإعدادات: Magpie كيبدّل المفتاح المحدد بلا ما يعاود يكتب باقي إعدادات الوكيل.
• بوابة محلية موحّدة: الوكلاء يقدرو يوصلو لنماذج من مزوّدين متعددين عبر نقطة نهاية loopback وحدة.
• ترجمة واجهات API: البوابة كتدعم طلبات متوافقة مع OpenAI Chat Completions وOpenAI Responses وAnthropic Messages وGoogle Gemini، بما فيها البث واستدعاءات الأدوات.
• اشتراكات مشتركة: تسجيلات الدخول الموجودة ديال Claude Code وCodex وCopilot تقدر تبان كمزوّدين لوكلاء آخرين.
• كتالوجات مباشرة للنماذج: Magpie كيجلب لوائح النماذج من المزوّدين وكيكمّلها ببيانات من models.dev.
• إعدادات جاهزة للمزوّدين: كاينة إعدادات جاهزة لمزوّدين وخدمات بحال Anthropic وOpenAI وGemini وDeepSeek وKimi وGLM وMiniMax وQwen وMistral وGroq وxAI وOpenRouter وTogether وOllama وLM Studio.
• الملفات الشخصية: حفظ جميع إعدادات الوكلاء الحالية تحت اسم واسترجاعها كاملة من بعد.
• إصدارات أصلية صغيرة: إصدار سطح المكتب كيستعمل webview ديال نظام التشغيل بلا ما يضمّن runtime ديال المتصفح.

ثبّت Magpie

ثبيت إصدار جاهز

حمّل تطبيق سطح المكتب لنظام macOS أو Windows أو Linux من usemagpie.ai. وتقدر حتى تشغّل سكريبت التثبيت:

curl -fsSL https://usemagpie.ai/install.sh | sh

فـ Linux، المثبّت كيختار تطبيق سطح المكتب إلا كان WebKitGTK 4.1 متوفر، وإلا كيثبّت إصدار سطر الأوامر. إصدارات macOS موقّعة وموثّقة من Apple. إصدارات Windows وLinux مازال ما موقّعاش حالياً، وبهذا Windows SmartScreen يقدر يبيّن تحذيراً فالمرة الأولى اللي كيتشغّل فيها التطبيق.

Magpie كيتحقّق من التحديثات فالخلفية. تطبيق سطح المكتب كيثبّت التحديث ملي كيعاد تشغيلو أو كيتسد، بينما مستعملو الطرفية يقدرو يديرو التحديث بشكل صريح:

magpie update

التثبيت من مصدر Go

إلا كان Go مثبّت عندك، ثبّت آخر إصدار مباشرة:

go install github.com/yetone/magpie@latest

بناء المستودع محلياً

المستودع كيوفّر عدة أهداف ديال Make:

make build            # ملف ثنائي لتطبيق سطح المكتب
make app              # تطبيق شريط القوائم ديال macOS
make cli              # إصدار للطرفية فقط بلا cgo
make release          # إصدارات أصلية للتطبيق وCLI متعدد المنصات
make release-windows  # إصدارات التطبيق لـ Windows amd64 وarm64
make release-linux    # تطبيق Linux للهندسة الحالية

بناء تطبيق سطح المكتب ديال Linux كيتطلب libgtk-3-dev وlibwebkit2gtk-4.1-dev. خاص البناء العادي ديال Go يستعمل وسم البناء gtk3. Windows كيستعمل runtime ديال WebView2 المضمّن فـ نظام التشغيل.

حلّ الواجهة

اختار الواجهة اللي مناسبة لطريقة الخدمة ديالك:

magpie          # حلّ نافذة وأيقونة شريط القوائم
magpie tray     # شغّل أيقونة شريط القوائم فقط
magpie tui      # حلّ واجهة الطرفية
magpie ls       # عرض الوكلاء المكتشفين والإعدادات الحالية

واجهة سطح المكتب كتخليك تنقر على أي قيمة حالية باش تحلّ أداة اختيار مفلترة. كتب باش تقلّب أو دخل قيمة مخصّصة، وضغط esc باش تسد أداة الاختيار.

فواجهة الطرفية، استعمل مفاتيح الأسهم باش تختار وكيلاً وحقلًا، وضغط Enter باش تحلّ أداة الاختيار ديالو، وكتب باش تصفّي الاختيارات المتاحة. ضغط q باش تخرج.

زِد مزوّد نماذج

عاين الإعدادات الجاهزة المتاحة

بدا بعرض المزوّدين اللي Magpie عارفهم من قبل:

magpie presets

الإعدادات الجاهزة مقسّمة لمزوّدين، ومرحّلات، وخدمات محلية. الإعداد الجاهز المستضاف كيحتاج غالباً غير لمفتاح API:

magpie provider add deepseek sk-…

المزوّدين المحليين بحال Ollama ما كيحتاجوش مفتاح:

magpie provider add ollama

Magpie ما كيقرأش مفاتيح المزوّدين من بيئة shell ديالك. زِدها من خلال التطبيق أو أوامر المزوّدين.

زِد مزوّداً مخصّصاً متوافقاً مع OpenAI

يمكن تهيئة مزوّد مخصّص باسم، ورابط أساسي، ومفتاح، ولائحة نماذج محددة:

magpie provider add "My Relay" url=https://relay.example.com/v1 key=sk-… models=gpt-5.5,claude-sonnet-5

المزوّدين المخصّصين يقدرو يستعملو url= لقاعدة متوافقة مع OpenAI، أو anthropic= لقاعدة متوافقة مع Anthropic، أو بجوج. استعمل responses= إلا كان عند المزوّد endpoint منفصل ديال Responses. والوسيط الاختياري catalog= يقدر يستعير البيانات الوصفية من مزوّد فـ models.dev.

عاين المزوّدين واختبرهم

استعمل هاد الأوامر باش تراجع المزوّدين، وتحدّث لوائح النماذج، وتختبر واجهات API، وتبدّل المفاتيح، أو تحيد إدخال:

magpie providers
magpie provider deepseek
magpie provider models deepseek
magpie provider test deepseek
magpie provider key deepseek sk-…
magpie provider rm deepseek
magpie models

magpie provider test كيدير طلب صغير واحد لكل API مدعوم وكيعطيك مدة الاستجابة. فالتطبيق المكتبي، التبويب ديال Providers كيوفّر نفس أدوات التحكم باش تبدّل المفاتيح، تختار الموديلات اللي باينين، تجرّب المزوّدين، وتعيّن موديلاتهم للوكلاء.

بدّل موديلات الوكلاء

الموديلات اللي كيبانُو عبر البوابة كيستعملو الصيغة provider/model. حتى موديلات الوكلاء الأصلية تقدر تختارها بالسميات المعتادة ديالها.

أمثلة أساسية على CLI

magpie claude opus
magpie codex gpt-5.6-sol
magpie codex effort high
magpie codex xhigh
magpie codex deepseek/deepseek-chat
magpie claude moonshot/kimi-k2.5
magpie gemini auth api-key
magpie opencode anthropic/claude-sonnet-5
magpie oc small anthropic/claude-haiku-4-5

سميات الوكلاء كتقبل اختصارات بحال cc وoc وgem. الوكلاء المرتابطين بمزوّد، بحال OpenCode وPi وGoose وCrush، كيستعملو معرفات provider/model.

إعداد مستويات Claude Code

Claude Code يقدر يعيّن موديلات مختلفة لمستويات بحال opus وsonnet وhaiku وfable. مثلا، عيّن موديل DeepSeek غير لمستوى haiku:

magpie claude haiku deepseek/deepseek-v4-flash

مسح الاختيار الخاص بهاد المستوى باش يرجع للموديل الرئيسي ديال Claude Code:

magpie claude haiku ""

ملي كتختار موديل ديال البوابة، Magpie كيدبّر متغيرات عنوان Anthropic الأساسي، والرمز، والموديل فـ settings.json ديال Claude Code. اختيار موديل أصلي كيمسح إعدادات البوابة ديال Magpie وكيرجّع القيم اللي كانت من قبل.

عاود شغّل الوكلاء من بعد التبديل

الوكلاء كيقراو الإعدادات ديالهم ملي كيبداو. الجلسة اللي راه خدامة كتكمل بالموديل القديم حتى كتبدا جلسة جديدة.

هادشي مهم خصوصا مع Codex، حيث كيقرا كاتالوغ الموديلات عند البداية وخصّو يعاود يتشغّل من بعد التبديل.

حفظ واسترجاع الإعدادات

الملف الشخصي كيسجّل الإعدادات الحالية ديال كل وكيل مكتاشف. هادشي مفيد باش تحافظ على إعدادات مختلفة للخدمة، والتجارب، والاستدلال المحلي، أو المهام اللي كتراعي التكلفة.

magpie save work
magpie use work
magpie profiles
magpie rm work

فالتطبيق المكتبي، الملفات الشخصية كيبانو على شكل شرائح فأسفل العرض الرئيسي. كليكي على شي شريحة باش تطبّقها، استعمل زر الحذف ديالها باش تحيدها، أو اختار + save current باش تنشئ ملفا شخصيا.

فالواجهة الطرفية، ضغط على s باش تحفظ الإعداد الحالي، وعلى p باش تطبّق أو تحيد ملفا شخصيا.

استعمل الوكلاء اللي داخلين للحساب كمزوّدين

Magpie يقدر يعرّض اشتراكات Claude Code وCodex وCopilot الموجودة عندك كمزوّدين. من بعد ما تدخل للحساب عبر الوكيل الأصلي، الموديلات المتاحة ديالو كتبان فـ magpie providers وفاختيارات الموديلات ديال الوكلاء الآخرين.

• موديلات Claude Code كتستعمل معرفات بحال claude/claude-sonnet-5.
• موديلات اشتراك Codex كتستعمل معرفات بحال codex/gpt-5.5.
• موديلات Copilot كتستعمل معرفات بحال copilot/claude-sonnet-4.5.

Magpie كيقرا بيانات الاعتماد الموجودة ديال الوكيل ملي كيحتاجها، وما كينسخهاش لمخزن المزوّدين ديالو. إلا بدّل الوكيل الأصلي الرمز، Magpie كيتبع مسار التحديث ديال داك الوكيل وكيكتب الرمز الجديد فالمكان اللي كيتسناه الوكيل. تسجيل الخروج كيحيد المزوّد المرتابط.

اشتراكات Claude كتحتاج تثبيت البرنامج المحلي الأصلي claude وتسجيل الدخول فيه. Magpie كيشغّل داك البرنامج وكيربط أدوات المستدعي بالدورة الجارية عبر MCP. دعم تسجيل الدخول بحساب Google ديال Gemini CLI مخطّط ليه، ولكن مازال ما متاحش كمزوّد مشترك.

ربط تطبيقات أخرى بالبوابة

بوابة Magpie كتسمع افتراضيا على 127.0.0.1:3425 وكتبدا مع التطبيق. باش تشغّل البوابة بوحدها، استعمل:

magpie serve

عيّن MAGPIE_ADDR باش تبدّل عنوان الاستماع. الربط الافتراضي مع loopback كيخلي البوابة محلية فالحاسوب ديالك.

نقاط API المدعومة

• /v1/chat/completions ديال OpenAI Chat Completions.
• /v1/responses ديال OpenAI Responses.
• /v1/messages ديال Anthropic Messages.
• /v1/messages/count_tokens ديال حساب الرموز فـ Anthropic.
• /v1beta/models/{model}:generateContent ديال توليد Gemini، مع نسخ البث وحساب الرموز.
• /v1/models و/v1beta/models ديال كاتالوغ الموديلات.

مفتاح API يقدر يكون القيمة الحرفية magpie؛ أي قيمة غادي تخدم حيث البوابة كتسمع افتراضيا غير على loopback. ديما حدّد الموديلات بصيغة provider/model.

بيئة متوافقة مع OpenAI

export OPENAI_BASE_URL=http://127.0.0.1:3425/v1
export OPENAI_API_KEY=magpie

بيئة متوافقة مع Anthropic

export ANTHROPIC_BASE_URL=http://127.0.0.1:3425
export ANTHROPIC_API_KEY=magpie

بيئة متوافقة مع Gemini

export GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:3425
export GEMINI_API_KEY=magpie

التبويب ديال Gateway فالتطبيق المكتبي كيوفّر إعدادات ومقاطع قابلة للنسخ للـ shell وcurl وPython وNode. وكيعرض حتى معرفات الموديلات والطلبات الأخيرة.

حدّث كاتالوغات الموديلات

Magpie كيجلب لوائح حقيقية ديال الموديلات من المزوّدين المهيّئين. كاتالوغ models.dev كيوفّر السميات، ومستويات التفكير، ولوائح احتياطية للمزوّدين اللي ما كينشروش الكاتالوغات ديالهم.

دير مزامنة كاملة ملي تبغي تحدّث معطيات models.dev وجميع لوائح المزوّدين المباشرة:

magpie sync

فواجهة الطرفية، ضغط على S باش تدير نفس العملية. وتقدر حتى تحدّث غير موفّر واحد باستعمال magpie provider models PROVIDER.

استورد روابط الموفّرين بأمان

البائعين ووسائل الترحيل يقدرو يوزّعو تعريفات معمّرة ديال الموفّرين باستعمال روابط الاستيراد. Magpie كيبين سميّة الموفّر المقترحة، ونقاط النهاية، والمضيفين الوجهة، والموديلات قبل ما يحفظ أي حاجة.

magpie import 'magpie://import?preset=deepseek&key=sk-…'

رابط ديال ترحيل مخصّص يقدر يضم نقاط نهاية منفصلة ديال OpenAI وAnthropic:

magpie://import?name=Acme%20Relay&chat=https://api.acme.example/v1&anthropic=https://api.acme.example&key=sk-…&models=gpt-5.5,claude-sonnet-5

ما كيتخزّن والو حتى كيأكّد المستخدم الاستيراد. صفحات الويب تقدر تستعمل https://usemagpie.ai/import# وتزيد من بعد نفس المَعلمات. حيث القيم كاتبقى فجزء الرابط، المتصفحات ما كتصيفطهاش لسيرفر الموقع. شوف دليل استيراد Magpie باش تلقى المرجع الكامل ديال المَعلمات وأداة إنشاء الروابط.

نصائح متقدّمة

حدّد الموديلات اللي باينة

ماشي ضروري تبيّن كل موديل كيرجّعو الموفّر. اختار غير الموديلات اللي بغيتي يبانُو فاختيارات الوكلاء. هاد الشي كيخلّي الكتالوجات الكبيرة سهلة التسيير وكيعاون يمنع اختيار موديل بالغلط.

عاين ترجمة البوّابة

فعّل تسجيل التصحيح باش تشوف شنو كترجم البوّابة:

MAGPIE_DEBUG=1 magpie serve

الطلبات كتدوز مباشرة ملي كيكون البائع كيهضر من الأصل بنفس API ديال المستعمل. وإلا، Magpie كيترجم الطلب والجواب مع الحفاظ على البث، واستدعاءات الأدوات، وسلوك الاستدلال المدعوم.

عرف فين كتتخزّن البيانات

• ~/.config/magpie/profiles.json كيخزّن البروفايلات المحفوظة.
• ~/.config/magpie/providers.json كيخزّن الموفّرين والمفاتيح ديالهم بصلاحيات الملف 0600.
• ~/.config/magpie/stash.json كيخزّن القيم اللي تعوّضات باش تقدر ترجعها.
• ~/.cache/magpie/models.json كيخزّن كتالوج models.dev.
• ~/.cache/magpie/models/<provider>.json كيخزّن لوائح الموديلات اللي تجرّات من الموفّرين.

Magpie كيدعم XDG_CONFIG_HOME وXDG_CACHE_HOME.

استعمل مجلّد تطوير معزول

المساهمين يقدرو يشغّلو نسخة التطوير بلا ما يمسّو إعدادات الوكلاء العادية ديالهم:

HOME=/tmp/magpie-home XDG_CONFIG_HOME=/tmp/magpie-home/.config make dev

make dev كيعرض الواجهة مباشرة من internal/gui/assets وكيعاود يحمّلها ملي كتتبدّل ملفات الواجهة الأمامية. البوّابة ديالو كتستعمل DEV_ADDR، والقيمة الافتراضية ديالها هي 127.0.0.1:3426، وبهذا تقدر تخدم حدّا نسخة Magpie عادية. عيّن MAGPIE_THEME=light ولا MAGPIE_THEME=dark باش تفرض لوحة ألوان معيّنة.

الخلاصة

Magpie كيعوّض إعدادات الموديلات المتفرّقة بسيرورة وحدة ومنظّمة. من بعد ما تثبّتو، زِد موفّراً ولا استعمل اشتراك وكيل موجود، واختار الموديلات لكل وكيل، وحفظ التركيبات المفيدة فبروفايلات. والبوّابة المحلية ديالو كتخلي حتى الأدوات الأخرى المتوافقة مع OpenAI وAnthropic وGemini تشارك نفس كتالوج الموفّرين، بلا ما تخزّن بيانات اعتماد البائع فكل تطبيق.