Magpie کے ساتھ AI ایجنٹ ماڈلز اور فراہم کنندگان کا نظم کریں

میگ پائی کیا کرتا ہے

میگ پائی آپ کے کمپیوٹر پر نصب AI ایجنٹس کے زیرِ استعمال ماڈلز دیکھنے اور تبدیل کرنے کے لیے ایک جگہ فراہم کرتا ہے۔ یہ مینو بار ایپلیکیشن، معمول کی ڈیسک ٹاپ ونڈو، ٹرمینل یوزر انٹرفیس، اور کمانڈ لائن ٹول کے طور پر دستیاب ہے۔

متعدد JSON، TOML، YAML، اور ماحول کی فائلوں میں دستی طور پر ترمیم کرنے کے بجائے، آپ ایک ایجنٹ منتخب کر کے کوئی فیلڈ چن سکتے ہیں اور اس کے لیے ایک ماڈل مقرر کر سکتے ہیں۔ میگ پائی صرف متعلقہ ترتیب میں ترمیم کرتا ہے اور جہاں ممکن ہو تبصروں، ترتیب، اور انڈینٹیشن کو برقرار رکھتا ہے۔ اس کی تحریری کارروائیاں ایٹامک ہوتی ہیں۔

میگ پائی فی الحال Claude Code، Codex، Gemini CLI، OpenCode، Pi، Goose، Cursor CLI، Copilot CLI، اور Crush کو پہچانتا ہے۔ اس کے انٹرفیس میں صرف وہی ایجنٹس دکھائی دیتے ہیں جو نصب یا ترتیب دیے گئے ہوں۔

اہم خصوصیات

• متعدد انٹرفیس: ڈیسک ٹاپ ایپلیکیشن، مینو بار پینل، ٹرمینل UI، یا سادہ CLI استعمال کریں۔
• ترتیب میں ہدفی ترمیم: میگ پائی ایجنٹ کی ترتیب کے باقی حصے کو دوبارہ لکھے بغیر منتخب کلید میں تبدیلی کرتا ہے۔
• متحدہ مقامی گیٹ وے: ایجنٹس ایک واحد لوپ بیک اینڈ پوائنٹ کے ذریعے متعدد فراہم کنندگان کے ماڈلز تک رسائی حاصل کر سکتے ہیں۔
• API ترجمہ: گیٹ وے OpenAI Chat Completions، OpenAI Responses، Anthropic Messages، اور Google Gemini سے مطابقت رکھنے والی درخواستوں کو سپورٹ کرتا ہے، جن میں اسٹریمنگ اور ٹول کالز بھی شامل ہیں۔
• مشترکہ سبسکرپشنز: موجودہ Claude Code، Codex، اور Copilot سائن اِنز دوسرے ایجنٹس کے لیے فراہم کنندگان کے طور پر ظاہر ہو سکتے ہیں۔
• براہِ راست ماڈل کیٹلاگ: میگ پائی فراہم کنندگان سے ماڈلز کی فہرستیں حاصل کرتا ہے اور models.dev کے ڈیٹا سے ان میں اضافہ کرتا ہے۔
• فراہم کنندگان کے پری سیٹس: Anthropic، OpenAI، Gemini، DeepSeek، Kimi، GLM، MiniMax، Qwen، Mistral، Groq، xAI، OpenRouter، Together، Ollama، اور LM Studio سمیت فراہم کنندگان اور سروسز کے لیے پری سیٹس دستیاب ہیں۔
• پروفائلز: ایجنٹ کی تمام موجودہ ترتیبات کو ایک نام کے تحت محفوظ کریں اور بعد میں انہیں ایک ساتھ بحال کریں۔
• چھوٹی مقامی بلڈز: ڈیسک ٹاپ بلڈ براؤزر رن ٹائم شامل کرنے کے بجائے آپریٹنگ سسٹم کا ویب ویو استعمال کرتا ہے۔

میگ پائی انسٹال کریں

پہلے سے تیار ریلیز انسٹال کریں

macOS، Windows، یا Linux کے لیے ڈیسک ٹاپ ایپلیکیشن usemagpie.ai سے ڈاؤن لوڈ کریں۔ آپ انسٹالیشن اسکرپٹ بھی چلا سکتے ہیں:

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

Linux پر، اگر WebKitGTK 4.1 دستیاب ہو تو انسٹالر ڈیسک ٹاپ ایپلیکیشن منتخب کرتا ہے، ورنہ کمانڈ لائن بلڈ انسٹال کرتا ہے۔ macOS ریلیزز پر دستخط اور نوٹرائز کیے گئے ہیں۔ Windows اور Linux بلڈز پر فی الحال دستخط نہیں کیے گئے، اس لیے پہلی بار چلانے پر Windows SmartScreen انتباہ دکھا سکتا ہے۔

میگ پائی پسِ منظر میں اپ ڈیٹس کی جانچ کرتا ہے۔ ڈیسک ٹاپ ایپلیکیشن دوبارہ شروع ہونے یا بند ہونے پر اپ ڈیٹ انسٹال کرتی ہے، جبکہ ٹرمینل صارفین واضح طور پر اپ ڈیٹ کر سکتے ہیں:

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 آپریٹنگ سسٹم کے ساتھ شامل WebView2 رن ٹائم استعمال کرتا ہے۔

انٹرفیس کھولیں

اپنے کام کے طریقے کے مطابق انٹرفیس منتخب کریں:

magpie          # ونڈو اور مینو بار آئیکن کھولیں
magpie tray     # صرف مینو بار آئیکن چلائیں
magpie tui      # ٹرمینل انٹرفیس کھولیں
magpie ls       # دریافت شدہ ایجنٹس اور موجودہ ترتیبات کی فہرست دکھائیں

ڈیسک ٹاپ انٹرفیس میں کسی بھی موجودہ قدر پر کلک کرنے سے فلٹر شدہ سلیکٹر کھلتا ہے۔ تلاش کے لیے ٹائپ کریں یا حسبِ ضرورت قدر درج کریں، اور سلیکٹر بند کرنے کے لیے esc دبائیں۔

ٹرمینل انٹرفیس میں ایجنٹ اور فیلڈ منتخب کرنے کے لیے تیر والے بٹن استعمال کریں، اس کے سلیکٹر کو کھولنے کے لیے Enter دبائیں، اور دستیاب انتخاب فلٹر کرنے کے لیے ٹائپ کریں۔ باہر نکلنے کے لیے q دبائیں۔

ماڈل فراہم کنندہ شامل کریں

دستیاب پری سیٹس دیکھیں

میگ پائی کے پہلے سے معلوم فراہم کنندگان کی فہرست دکھا کر شروع کریں:

magpie presets

پری سیٹس کو فراہم کنندگان، ریلے، اور مقامی سروسز میں تقسیم کیا گیا ہے۔ میزبان پری سیٹ کے لیے عموماً صرف API کلید درکار ہوتی ہے:

magpie provider add deepseek sk-…

Ollama جیسے مقامی فراہم کنندگان کے لیے کلید درکار نہیں ہوتی:

magpie provider add ollama

میگ پائی آپ کے شیل ماحول سے فراہم کنندگان کی کلیدیں نہیں پڑھتا۔ انہیں اس کے بجائے ایپلیکیشن یا فراہم کنندہ کمانڈز کے ذریعے شامل کریں۔

حسبِ ضرورت OpenAI سے مطابقت رکھنے والا فراہم کنندہ شامل کریں

حسبِ ضرورت فراہم کنندہ کو نام، بنیادی URL، کلید، اور ماڈلز کی واضح فہرست کے ساتھ ترتیب دیا جا سکتا ہے:

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

حسبِ ضرورت فراہم کنندگان OpenAI سے مطابقت رکھنے والے بنیادی پتے کے لیے url=، Anthropic سے مطابقت رکھنے والے بنیادی پتے کے لیے anthropic=، یا دونوں استعمال کر سکتے ہیں۔ اگر فراہم کنندہ کا Responses اینڈ پوائنٹ الگ ہو تو responses= استعمال کریں۔ اختیاری catalog= دلیل models.dev کے کسی فراہم کنندہ سے میٹا ڈیٹا حاصل کر سکتی ہے۔

فراہم کنندگان کا معائنہ اور آزمائش

فراہم کنندگان کا جائزہ لینے، ماڈل فہرستیں تازہ کرنے، APIs کی جانچ کرنے، کلیدیں تبدیل کرنے، یا کوئی اندراج ہٹانے کے لیے یہ کمانڈز استعمال کریں:

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، Claude Code کی settings.json میں Anthropic کا بنیادی URL، ٹوکن اور ماڈل متغیرات کا انتظام کرتا ہے۔ مقامی ماڈل منتخب کرنے سے Magpie کی گیٹ وے ترتیبات ہٹ جاتی ہیں اور سابقہ اقدار بحال ہو جاتی ہیں۔

تبدیلی کے بعد ایجنٹس دوبارہ شروع کریں

ایجنٹس شروع ہوتے وقت اپنی ترتیب پڑھتے ہیں۔ پہلے سے چلتا ہوا سیشن نیا سیشن شروع کرنے تک اپنا سابقہ ماڈل استعمال کرتا رہتا ہے۔

یہ Codex کے لیے خاص طور پر اہم ہے، کیونکہ وہ اپنا ماڈل کیٹلاگ آغاز کے وقت پڑھتا ہے اور تبدیلی کے بعد اسے دوبارہ شروع کرنا ضروری ہے۔

پروفائل محفوظ اور بحال کریں

ایک پروفائل ہر شناخت شدہ ایجنٹ کی موجودہ ترتیبات محفوظ کرتا ہے۔ یہ کام، تجربات، مقامی inference یا کم لاگت والے کاموں کے لیے الگ ترتیبات برقرار رکھنے میں مفید ہے۔

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 کے ذریعے کال کرنے والے ٹولز کو فعال turn سے جوڑتا ہے۔ Gemini CLI کا Google login support منصوبہ بندی میں ہے، لیکن فی الحال مشترکہ فراہم کنندہ کے طور پر دستیاب نہیں۔

دیگر ایپلیکیشنز کو گیٹ وے سے جوڑیں

Magpie کا گیٹ وے پہلے سے 127.0.0.1:3425 پر سنتا ہے اور ایپلیکیشن کے ساتھ شروع ہو جاتا ہے۔ صرف گیٹ وے چلانے کے لیے استعمال کریں:

magpie serve

سننے کا پتہ تبدیل کرنے کے لیے MAGPIE_ADDR مقرر کریں۔ پہلے سے موجود loopback binding گیٹ وے کو آپ کے کمپیوٹر تک محدود رکھتی ہے۔

معاون API اینڈ پوائنٹس

• OpenAI Chat Completions کے لیے /v1/chat/completions۔
• OpenAI Responses کے لیے /v1/responses۔
• Anthropic Messages کے لیے /v1/messages۔
• Anthropic ٹوکن گنتی کے لیے /v1/messages/count_tokens۔
• Gemini generation کے لیے /v1beta/models/{model}:generateContent، اس کے streaming اور token-counting متغیرات سمیت۔
• ماڈل کیٹلاگ کے لیے /v1/models اور /v1beta/models۔

API key لفظی قدر magpie ہو سکتی ہے؛ کوئی بھی قدر کام کرے گی کیونکہ گیٹ وے پہلے سے loopback پر سنتا ہے۔ ماڈلز ہمیشہ provider/model کے طور پر متعین کریں۔

OpenAI-Compatible ماحول

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

Anthropic-Compatible ماحول

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

Gemini-Compatible ماحول

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

ڈیسک ٹاپ ایپلیکیشن کا Gateway ٹیب shell، curl، Python اور Node کے لیے نقل کیے جا سکنے والے سیٹنگز اور snippets فراہم کرتا ہے۔ یہ ماڈل IDs اور حالیہ calls بھی دکھاتا ہے۔

ماڈل کیٹلاگز ریفریش کریں

Magpie ترتیب دیے گئے فراہم کنندگان سے حقیقی ماڈل فہرستیں حاصل کرتا ہے۔ models.dev کیٹلاگ ان فراہم کنندگان کے لیے نام، reasoning levels اور fallback lists فراہم کرتا ہے جو اپنے کیٹلاگز شائع نہیں کرتے۔

جب models.dev کا ڈیٹا اور تمام فعال فراہم کنندگان کی فہرستیں ریفریش کرنی ہوں تو مکمل synchronization چلائیں:

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# استعمال کر سکتے ہیں۔ چونکہ اقدار URL کے fragment میں رہتی ہیں، اس لیے براؤزر انہیں ویب سائٹ کے سرور کو نہیں بھیجتے۔ مکمل پیرامیٹر حوالہ اور لنک بلڈر کے لیے 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 سے مطابقت رکھنے والے ٹولز کو بھی ہر ایپلی کیشن میں وینڈر کی اسناد محفوظ کیے بغیر اسی فراہم کنندہ کیٹلاگ کا اشتراک کرنے دیتا ہے۔