Magpie yordamida AI agent modellari va provayderlarini boshqaring

Magpie nima qiladi

Magpie kompyuteringizda o‘rnatilgan AI agentlari foydalanadigan modellarni ko‘rish va o‘zgartirish uchun yagona joyni taqdim etadi. U menyu satri ilovasi, oddiy ish stoli oynasi, terminal foydalanuvchi interfeysi va buyruq satri vositasi sifatida mavjud.

Bir nechta JSON, TOML, YAML va muhit fayllarini qo‘lda tahrirlash o‘rniga agentni tanlashingiz, maydonni belgilashingiz va model tayinlashingiz mumkin. Magpie faqat tegishli sozlamani o‘zgartiradi hamda mavjud bo‘lsa, izohlar, tartib va chekinishlarni saqlab qoladi. Uning yozish amallari atomik tarzda bajariladi.

Magpie hozirda Claude Code, Codex, Gemini CLI, OpenCode, Pi, Goose, Cursor CLI, Copilot CLI va Crush dasturlarini taniydi. Interfeysda faqat o‘rnatilgan yoki sozlangan agentlar ko‘rsatiladi.

Asosiy imkoniyatlar

• Bir nechta interfeys: Ish stoli ilovasi, menyu satri paneli, terminal interfeysi yoki oddiy CLI’dan foydalaning.
• Sozlamalarni aniq tahrirlash: Magpie agent konfiguratsiyasining qolgan qismini qayta yozmasdan, tanlangan kalitni o‘zgartiradi.
• Yagona lokal shlyuz: Agentlar bitta loopback endpoint orqali bir nechta yetkazib beruvchining modellaridan foydalanishi mumkin.
• API tarjimasi: Shlyuz OpenAI Chat Completions, OpenAI Responses, Anthropic Messages va Google Gemini bilan mos so‘rovlarni, jumladan oqimli uzatish va vositalar chaqiruvlarini qo‘llab-quvvatlaydi.
• Umumiy obunalar: Mavjud Claude Code, Codex va Copilot hisoblari boshqa agentlar uchun provayder sifatida ko‘rinishi mumkin.
• Jonli modellar kataloglari: Magpie provayderlardan modellar ro‘yxatini oladi va uni models.dev ma’lumotlari bilan to‘ldiradi.
• Provayder presetlari: Anthropic, OpenAI, Gemini, DeepSeek, Kimi, GLM, MiniMax, Qwen, Mistral, Groq, xAI, OpenRouter, Together, Ollama va LM Studio kabi yetkazib beruvchi hamda xizmatlar uchun presetlar mavjud.
• Profillar: Agentlarning barcha joriy sozlamalarini nom ostida saqlang va keyinroq ularni birgalikda tiklang.
• Kichik hajmli native buildlar: Ish stoli buildi brauzer runtime’ini ichiga qo‘shish o‘rniga operatsion tizimning webview komponentidan foydalanadi.

Magpie’ni o‘rnatish

Tayyor relizni o‘rnatish

macOS, Windows yoki Linux uchun ish stoli ilovasini usemagpie.ai saytidan yuklab oling. Shuningdek, o‘rnatish skriptini ishga tushirishingiz mumkin:

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

Linux’da WebKitGTK 4.1 mavjud bo‘lsa, o‘rnatuvchi ish stoli ilovasini tanlaydi; aks holda buyruq satri buildini o‘rnatadi. macOS relizlari imzolangan va notarial tasdiqlangan. Windows va Linux buildlari hozircha imzolanmagan, shuning uchun Windows SmartScreen birinchi ishga tushirishda ogohlantirish ko‘rsatishi mumkin.

Magpie yangilanishlarni fonda tekshiradi. Ish stoli ilovasi qayta ishga tushirilganda yoki yopilganda yangilanishni o‘rnatadi, terminal foydalanuvchilari esa yangilashni aniq buyruq bilan bajarishlari mumkin:

magpie update

Go manba kodidan o‘rnatish

Agar Go o‘rnatilgan bo‘lsa, eng so‘nggi versiyani to‘g‘ridan-to‘g‘ri o‘rnating:

go install github.com/yetone/magpie@latest

Repozitoriyani lokal ravishda build qilish

Repozitoriyda bir nechta Make targetlari mavjud:

make build            # Ish stoli ilovasi binar fayli
make app              # macOS menyu satri ilovasi
make cli              # cgo’siz, faqat terminal uchun build
make release          # Native ilova va kross-platformali CLI buildlari
make release-windows  # Windows amd64 va arm64 ilova buildlari
make release-linux    # Joriy arxitektura uchun Linux ilovasi

Linux ish stoli ilovasini build qilish uchun libgtk-3-dev va libwebkit2gtk-4.1-dev kerak. Oddiy Go buildida gtk3 build tegi ishlatilishi shart. Windows operatsion tizim tarkibida mavjud WebView2 runtime’dan foydalanadi.

Interfeysni ochish

Ish jarayoningizga mos interfeysni tanlang:

magpie          # Oyna va menyu satri ikonkasini ochish
magpie tray     # Faqat menyu satri ikonkasini ishga tushirish
magpie tui      # Terminal interfeysini ochish
magpie ls       # Aniqlangan agentlar va joriy sozlamalarni ro‘yxatlash

Ish stoli interfeysida istalgan joriy qiymatni bosib, filtrlangan tanlash oynasini ochishingiz mumkin. Qidirish uchun yozing yoki maxsus qiymat kiriting, tanlash oynasini yopish uchun esc tugmasini bosing.

Terminal interfeysida agent va maydonni tanlash uchun strelka tugmalaridan foydalaning, uning tanlash oynasini ochish uchun Enter tugmasini bosing va mavjud variantlarni filtrlash uchun yozing. Chiqish uchun q tugmasini bosing.

Model provayderini qo‘shish

Mavjud presetlarni ko‘rish

Avval Magpie biladigan provayderlarni ro‘yxatlang:

magpie presets

Presetlar yetkazib beruvchilar, relaylar va lokal xizmatlar bo‘yicha guruhlangan. Joylashtirilgan preset uchun odatda faqat API kaliti kerak bo‘ladi:

magpie provider add deepseek sk-…

Ollama kabi lokal provayderlar kalitni talab qilmaydi:

magpie provider add ollama

Magpie provayder kalitlarini shell muhitidan o‘qimaydi. Ularni ilova yoki provayder buyruqlari orqali qo‘shing.

Maxsus OpenAI bilan mos provayder qo‘shish

Maxsus provayder nom, bazaviy URL, kalit va modellar ro‘yxati bilan sozlanishi mumkin:

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

Maxsus provayderlar OpenAI bilan mos bazaviy manzil uchun url=, Anthropic bilan mos bazaviy manzil uchun anthropic= yoki ikkalasidan foydalanishi mumkin. Provayderda alohida Responses endpointi bo‘lsa, responses= dan foydalaning. Ixtiyoriy catalog= argumenti models.dev provayderidan metama’lumotlarni olishi mumkin.

Provayderlarni ko‘rish va sinash

Provayderlarni ko‘rib chiqish, modellar ro‘yxatini yangilash, API’larni sinash, kalitlarni almashtirish yoki yozuvni o‘chirish uchun quyidagi buyruqlardan foydalaning:

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 har bir qo‘llab-quvvatlanadigan API uchun bittadan kichik so‘rov yuboradi va kechikishni ko‘rsatadi. Ish stoli ilovasidagi Providers oynasi kalitlarni o‘zgartirish, ochiq modellarni tanlash, provayderlarni sinash va ularning modellarini agentlarga biriktirish uchun xuddi shunday boshqaruvlarni taqdim etadi.

Agent modellarini almashtirish

Shlyuz orqali ochilgan modellar provider/model shaklidan foydalanadi. Mahalliy agent modellarini ham odatiy nomlari orqali tanlash mumkin.

CLI asosiy misollari

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

Agent nomlari cc, oc va gem kabi prefikslarni qabul qiladi. OpenCode, Pi, Goose va Crush kabi provayverga tegishli agentlar provider/model identifikatorlaridan foydalanadi.

Claude Code darajalarini sozlash

Claude Code opus, sonnet, haiku va fable kabi darajalarga alohida modellarni biriktirishi mumkin. Masalan, DeepSeek modelini faqat haiku darajasiga biriktiring:

magpie claude haiku deepseek/deepseek-v4-flash

Darajaga xos tanlovni tozalab, uni Claude Code’ning asosiy modeliga qaytaring:

magpie claude haiku ""

Shlyuz modeli tanlanganda, Magpie Claude Code’ning settings.json faylida Anthropic asosiy URL manzili, tokeni va model o‘zgaruvchilarini boshqaradi. Mahalliy model tanlansa, Magpie shlyuz sozlamalarini olib tashlaydi va avvalgi qiymatlarni tiklaydi.

Almashtirgandan keyin agentlarni qayta ishga tushirish

Agentlar sozlamalarini ishga tushgan paytda o‘qiydi. Ishlayotgan sessiya yangi sessiya boshlamaguningizcha avvalgi modeldan foydalanishda davom etadi.

Bu Codex uchun ayniqsa muhim, chunki u model katalogini ishga tushganda o‘qiydi va almashtirgandan keyin qayta ishga tushirilishi kerak.

Profillarni saqlash va tiklash

Profil aniqlangan har bir agentning joriy sozlamalarini saqlaydi. Bu ish, tajriba, mahalliy inferensiya yoki xarajatni tejashga yo‘naltirilgan vazifalar uchun alohida konfiguratsiyalarni yuritishda foydalidir.

magpie save work
magpie use work
magpie profiles
magpie rm work

Ish stoli ilovasida profillar asosiy ko‘rinishning pastki qismida chiplar sifatida ko‘rinadi. Profilni qo‘llash uchun chipni bosing, o‘chirish uchun uning o‘chirish boshqaruvidan foydalaning yoki profil yaratish uchun + save current bandini tanlang.

Terminal interfeysida joriy sozlamalarni saqlash uchun s tugmasini, profilni qo‘llash yoki o‘chirish uchun esa p tugmasini bosing.

Tizimga kirilgan agentlardan provayder sifatida foydalanish

Magpie mavjud Claude Code, Codex va Copilot obunalarini provayder sifatida ochishi mumkin. Asl agent orqali tizimga kirganingizdan so‘ng, undagi mavjud modellar magpie providers buyrug‘ida va boshqa agentlarning model tanlagichlarida ko‘rinadi.

• Claude Code modellari claude/claude-sonnet-5 kabi identifikatorlardan foydalanadi.
• Codex obuna modellari codex/gpt-5.5 kabi identifikatorlardan foydalanadi.
• Copilot modellari copilot/claude-sonnet-4.5 kabi identifikatorlardan foydalanadi.

Magpie kerak bo‘lganda agentning mavjud ma’lumotlaridan foydalanadi va ularni o‘z provayderlar omboriga ko‘chirmaydi. Agar asl agent tokenni yangilasa, Magpie shu agentning yangilash jarayonidan foydalanadi va yangilangan tokenni agent kutgan joyga yozadi. Tizimdan chiqish tegishli provayderni olib tashlaydi.

Claude obunalari uchun haqiqiy mahalliy claude binar fayli o‘rnatilgan va tizimga kirilgan bo‘lishi kerak. Magpie ushbu binar faylni ishga tushiradi va chaqiruvchi vositalarni MCP orqali faol navbatdagi jarayonga ulaydi. Gemini CLI Google orqali kirishni qo‘llab-quvvatlash rejalashtirilgan, ammo hozircha umumiy provayder sifatida mavjud emas.

Boshqa ilovalarni shlyuzga ulash

Magpie shlyuzi sukut bo‘yicha 127.0.0.1:3425 manzilida tinglaydi va ilova bilan birga ishga tushadi. Faqat shlyuzni ishga tushirish uchun quyidagidan foydalaning:

magpie serve

Tinglash manzilini o‘zgartirish uchun MAGPIE_ADDR qiymatini belgilang. Sukut bo‘yicha loopback ulanishi shlyuzni kompyuteringizda mahalliy holda saqlaydi.

Qo‘llab-quvvatlanadigan API endpointlari

• OpenAI Chat Completions uchun /v1/chat/completions.
• OpenAI Responses uchun /v1/responses.
• Anthropic Messages uchun /v1/messages.
• Anthropic tokenlarini hisoblash uchun /v1/messages/count_tokens.
• Gemini generatsiyasi uchun /v1beta/models/{model}:generateContent, jumladan oqimli va token hisoblash variantlari.
• Modellar katalogi uchun /v1/models va /v1beta/models.

API kaliti aynan magpie qiymatiga teng bo‘lishi mumkin; shlyuz sukut bo‘yicha loopback manzilida tinglagani uchun istalgan qiymat ishlaydi. Modellarni har doim provider/model shaklida ko‘rsating.

OpenAI bilan mos muhit

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

Anthropic bilan mos muhit

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

Gemini bilan mos muhit

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

Ish stoli ilovasining Gateway oynasi qobiq, curl, Python va Node uchun nusxalash mumkin bo‘lgan sozlamalar hamda parchalarni taqdim etadi. Shuningdek, unda model identifikatorlari va so‘nggi chaqiruvlar ko‘rsatiladi.

Model kataloglarini yangilash

Magpie sozlangan provayderlardan haqiqiy model ro‘yxatlarini oladi. models.dev katalogi o‘z kataloglarini e’lon qilmaydigan provayderlar uchun nomlar, mantiqiy fikrlash darajalari va zaxira ro‘yxatlarini taqdim etadi.

models.dev ma’lumotlari va barcha faol provayder ro‘yxatlarini yangilashni istaganingizda to‘liq sinxronizatsiyani ishga tushiring:

magpie sync

Terminal interfeysida xuddi shu amal uchun S tugmasini bosing. Shuningdek, magpie provider models PROVIDER buyrug‘i orqali faqat bitta provayderni yangilashingiz mumkin.

Provayder havolalarini xavfsiz import qilish

Vendors va relaylar import havolalari yordamida oldindan to‘ldirilgan provayder ta’riflarini tarqatishi mumkin. Magpie hech narsani saqlashdan oldin taklif qilinayotgan provayder nomi, endpointlar, manzil xostlari va modellarni ko‘rsatadi.

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

Maxsus relay havolasida alohida OpenAI va Anthropic endpointlari bo‘lishi mumkin:

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

Foydalanuvchi importni tasdiqlamaguncha hech narsa saqlanmaydi. Veb-sahifalar xuddi shu parametrlardan keyin https://usemagpie.ai/import# manzilidan foydalanishi mumkin. Qiymatlar URL fragmentida qolgani sababli brauzerlar ularni veb-sayt serveriga yubormaydi. Parametrlarning to‘liq ma’lumotnomasi va havola yaratish vositasi uchun Magpie import qo‘llanmasiga qarang.

Ilg‘or maslahatlar

Ko‘rsatiladigan modellarni cheklash

Provayder qaytargan barcha modellarni ko‘rsatishingiz shart emas. Agent tanlagichlarida ko‘rinishini istagan modellarnigina tanlang. Bu katta kataloglarni boshqarishni osonlashtiradi va modelni tasodifan tanlab qo‘yishning oldini olishga yordam beradi.

Gateway tarjimasini tekshirish

Gateway nimani tarjima qilayotganini ko‘rish uchun debug jurnalini yoqing:

MAGPIE_DEBUG=1 magpie serve

Vendor chaqiruvchi API tilini allaqachon qo‘llab-quvvatlasa, so‘rovlar to‘g‘ridan-to‘g‘ri uzatiladi. Aks holda, Magpie qo‘llab-quvvatlanadigan streaming, tool-call va reasoning xatti-harakatlarini saqlagan holda so‘rov va javobni tarjima qiladi.

Ma’lumotlar qayerda saqlanishini bilish

• ~/.config/magpie/profiles.json saqlangan profillarni saqlaydi.
• ~/.config/magpie/providers.json provayderlar va ularning kalitlarini 0600 fayl rejimida saqlaydi.
• ~/.config/magpie/stash.json almashtirilgan qiymatlarni tiklash mumkin bo‘lishi uchun saqlaydi.
• ~/.cache/magpie/models.json models.dev katalogini saqlaydi.
• ~/.cache/magpie/models/<provider>.json provayderlardan olingan modellar ro‘yxatini saqlaydi.

Magpie XDG_CONFIG_HOME va XDG_CACHE_HOME o‘zgaruvchilarini qo‘llab-quvvatlaydi.

Izolyatsiyalangan ishlab chiqish muhitidan foydalanish

Hissa qo‘shuvchilar odatiy agent konfiguratsiyalariga tegmasdan ishlab chiqish versiyasini ishga tushirishlari mumkin:

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

make dev interfeysni to‘g‘ridan-to‘g‘ri internal/gui/assets manzilidan taqdim etadi va frontend fayllari o‘zgarganda uni qayta yuklaydi. Uning gateway’i DEV_ADDR dan foydalanadi; standart qiymat 127.0.0.1:3426, shuning uchun u odatiy Magpie nusxasi bilan yonma-yon ishlashi mumkin. Ranglar palitrasini majburan tanlash uchun MAGPIE_THEME=light yoki MAGPIE_THEME=dark ni belgilang.

Xulosa

Magpie tarqoq model konfiguratsiyasini yagona va izchil ish jarayoni bilan almashtiradi. Uni o‘rnatgach, provayder qo‘shing yoki mavjud agent obunasidan foydalaning, har bir agent uchun modellarni tanlang va foydali kombinatsiyalarni profil sifatida saqlang. Uning lokal gateway’i boshqa OpenAI-, Anthropic- va Gemini-mos vositalarga ham har bir ilovada vendor hisob ma’lumotlarini saqlamasdan bir xil provayder katalogidan foydalanish imkonini beradi.