Dhibiti Miundo na Watoa Huduma wa Mawakala wa AI kwa Magpie

Magpie Hufanya Nini

Magpie hutoa sehemu moja ya kuangalia na kubadilisha modeli zinazotumiwa na mawakala wa AI waliosakinishwa kwenye kompyuta yako. Inapatikana kama programu ya upau wa menyu, dirisha la kawaida la kompyuta, kiolesura cha mtumiaji cha terminali, na zana ya mstari wa amri.

Badala ya kuhariri mwenyewe faili kadhaa za JSON, TOML, YAML na mazingira, unaweza kuchagua wakala, kuchagua sehemu, na kumpangia modeli. Magpie hubadilisha mpangilio unaohusika pekee, huku ikihifadhi maoni, mpangilio na nafasi za ndani inapofaa. Maandishi yake hufanyika kwa njia ya atomiki.

Kwa sasa Magpie inatambua Claude Code, Codex, Gemini CLI, OpenCode, Pi, Goose, Cursor CLI, Copilot CLI na Crush. Ni mawakala waliosakinishwa au kusanidiwa pekee wanaoonekana kwenye kiolesura chake.

Vipengele Muhimu

• Violesura vingi: Tumia programu ya kompyuta, paneli ya upau wa menyu, kiolesura cha terminali au CLI ya kawaida.
• Uhariri sahihi wa usanidi: Magpie hubadilisha ufunguo uliochaguliwa bila kuandika upya sehemu nyingine ya usanidi wa wakala.
• Lango la pamoja la ndani: Mawakala wanaweza kufikia modeli kutoka kwa wauzaji wengi kupitia kituo kimoja cha loopback.
• Tafsiri ya API: Lango linaunga mkono maombi yanayooana na OpenAI Chat Completions, OpenAI Responses, Anthropic Messages na Google Gemini, pamoja na utiririshaji na miito ya zana.
• Usajili wa pamoja: Akaunti zilizopo za Claude Code, Codex na Copilot zinaweza kuonekana kama watoa huduma kwa mawakala wengine.
• Katalogi za modeli za moja kwa moja: Magpie hupata orodha za modeli kutoka kwa watoa huduma na kuzikamilisha kwa data kutoka models.dev.
• Violezo vya watoa huduma: Violezo vinapatikana kwa wauzaji na huduma kama Anthropic, OpenAI, Gemini, DeepSeek, Kimi, GLM, MiniMax, Qwen, Mistral, Groq, xAI, OpenRouter, Together, Ollama na LM Studio.
• Wasifu: Hifadhi mipangilio yote ya sasa ya mawakala chini ya jina na uirejeshe pamoja baadaye.
• Miundo midogo ya asili: Muundo wa kompyuta hutumia webview ya mfumo wa uendeshaji badala ya kuunganisha runtime ya kivinjari.

Sakinisha Magpie

Sakinisha Toleo Lililotengenezwa Tayari

Pakua programu ya kompyuta kwa macOS, Windows au Linux kutoka usemagpie.ai. Unaweza pia kuendesha hati ya usakinishaji:

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

Kwenye Linux, kisakinishi huchagua programu ya kompyuta wakati WebKitGTK 4.1 inapatikana; vinginevyo husakinisha muundo wa mstari wa amri. Matoleo ya macOS yamesainiwa na kuthibitishwa na notarization. Miundo ya Windows na Linux kwa sasa haijasainiwa, hivyo Windows SmartScreen inaweza kuonyesha onyo wakati wa uzinduzi wa kwanza.

Magpie hukagua masasisho chinichini. Programu ya kompyuta husakinisha sasisho inapoanzishwa upya au kufungwa, huku watumiaji wa terminali wakiweza kusasisha waziwazi:

magpie update

Sakinisha kutoka kwenye Chanzo cha Go

Ikiwa Go imesakinishwa, sakinisha toleo jipya moja kwa moja:

go install github.com/yetone/magpie@latest

Jenga Hazina Ndani

Hazina hutoa malengo kadhaa ya Make:

make build            # Bainari ya programu ya kompyuta
make app              # Programu ya upau wa menyu ya macOS
make cli              # Muundo wa terminali pekee bila cgo
make release          # Miundo ya programu asili na CLI ya mifumo mbalimbali
make release-windows  # Miundo ya programu ya Windows amd64 na arm64
make release-linux    # Programu ya Linux kwa usanifu wa sasa

Kujenga programu ya kompyuta ya Linux kunahitaji libgtk-3-dev na libwebkit2gtk-4.1-dev. Muundo wa kawaida wa Go lazima utumie lebo ya kujenga ya gtk3. Windows hutumia runtime ya WebView2 iliyojumuishwa kwenye mfumo wa uendeshaji.

Fungua Kiolesura

Chagua kiolesura kinacholingana na mtiririko wako wa kazi:

magpie          # Fungua dirisha na ikoni ya upau wa menyu
magpie tray     # Endesha ikoni ya upau wa menyu pekee
magpie tui      # Fungua kiolesura cha terminali
magpie ls       # Orodhesha mawakala waliotambuliwa na mipangilio ya sasa

Kiolesura cha kompyuta hukuruhusu kubofya thamani yoyote ya sasa ili kufungua kiteuzi kilichochujwa. Andika kutafuta au ingiza thamani maalum, kisha bonyeza esc kufunga kiteuzi.

Kwenye kiolesura cha terminali, tumia vitufe vya mishale kuchagua wakala na sehemu, bonyeza Enter kufungua kiteuzi chake, na andika kuchuja chaguo zinazopatikana. Bonyeza q kuondoka.

Ongeza Mtoa Huduma wa Modeli

Kagua Violezo Vinavyopatikana

Anza kwa kuorodhesha watoa huduma ambao Magpie tayari inawajua:

magpie presets

Violezo vimepangwa katika wauzaji, relay na huduma za ndani. Kwa kawaida kiolezo cha huduma iliyopangishwa huhitaji tu ufunguo wa API:

magpie provider add deepseek sk-…

Watoa huduma wa ndani kama Ollama hawahitaji ufunguo:

magpie provider add ollama

Magpie haisomi funguo za watoa huduma kutoka kwenye mazingira ya shell yako. Ziongeze kupitia programu au amri za mtoa huduma badala yake.

Ongeza Mtoa Huduma Maalum Anayeoana na OpenAI

Mtoa huduma maalum anaweza kusanidiwa kwa jina, URL ya msingi, ufunguo na orodha ya modeli iliyoainishwa wazi:

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

Watoa huduma maalum wanaweza kutumia url= kwa msingi unaooana na OpenAI, anthropic= kwa msingi unaooana na Anthropic, au zote mbili. Tumia responses= wakati mtoa huduma ana endpoint tofauti ya Responses. Hoja ya hiari ya catalog= inaweza kukopa metadata kutoka kwa mtoa huduma wa models.dev.

Kagua na Jaribu Watoa Huduma

Tumia amri hizi kukagua watoa huduma, kusasisha orodha za modeli, kujaribu API, kubadilisha funguo au kuondoa ingizo:

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 hufanya ombi moja dogo kwa kila API inayotumika na kuripoti muda wa kusubiri. Katika programu ya kompyuta, kichupo cha Providers hutoa vidhibiti sawa vya kubadilisha funguo, kuchagua modeli zinazoonyeshwa, kujaribu watoa huduma, na kugawa modeli zao kwa mawakala.

Badilisha Modeli za Mawakala

Modeli zinazoonyeshwa kupitia lango hutumia muundo wa provider/model. Modeli asili za mawakala pia zinaweza kuchaguliwa kwa majina yao ya kawaida.

Mifano ya Msingi ya 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

Majina ya mawakala yanakubali viambishi kama cc, oc, na gem. Mawakala wanaohusishwa na mtoa huduma, wakiwemo OpenCode, Pi, Goose, na Crush, hutumia vitambulisho vya provider/model.

Sanidi Viwango vya Claude Code

Claude Code inaweza kugawa modeli tofauti kwa viwango kama opus, sonnet, haiku, na fable. Kwa mfano, gawia modeli ya DeepSeek kwenye kiwango cha haiku pekee:

magpie claude haiku deepseek/deepseek-v4-flash

Futa chaguo hilo maalum la kiwango ili kukirejesha kwenye modeli kuu ya Claude Code:

magpie claude haiku ""

Lango linapochaguliwa, Magpie hudhibiti URL ya msingi ya Anthropic, tokeni, na vigeu vya modeli katika settings.json ya Claude Code. Modeli asili inapochaguliwa, Magpie huondoa mipangilio yake ya lango na kurejesha thamani za awali.

Anzisha Upya Mawakala Baada ya Kubadilisha

Mawakala husoma usanidi wao wanapoanza. Kipindi ambacho tayari kinaendelea kitaendelea kutumia modeli yake ya awali hadi uanzishe kipindi kipya.

Hili ni muhimu hasa kwa Codex, ambayo husoma katalogi yake ya modeli wakati wa kuanza na lazima ianzishwe upya baada ya kubadilisha.

Hifadhi na Rejesha Wasifu

Wasifu hunasa mipangilio ya sasa ya kila wakala aliyegunduliwa. Hii ni muhimu kwa kudumisha usanidi tofauti wa kazi, majaribio, uendeshaji wa ndani, au majukumu yanayozingatia gharama.

magpie save work
magpie use work
magpie profiles
magpie rm work

Katika programu ya kompyuta, wasifu huonekana kama vibandiko chini ya mwonekano mkuu. Bofya kibandiko ili kukitumia, tumia kidhibiti chake cha kufuta ili kukiondoa, au chagua + save current kuunda wasifu.

Katika kiolesura cha terminali, bonyeza s ili kuhifadhi usanidi wa sasa na p ili kutumia au kufuta wasifu.

Tumia Mawakala Walioingia Kama Watoa Huduma

Magpie inaweza kuonyesha usajili uliopo wa Claude Code, Codex, na Copilot kama watoa huduma. Baada ya kuingia kupitia wakala asili, modeli zake zinazopatikana huonekana katika magpie providers na katika viteuzi vya modeli vya mawakala wengine.

• Modeli za Claude Code hutumia vitambulisho kama claude/claude-sonnet-5.
• Modeli za usajili wa Codex hutumia vitambulisho kama codex/gpt-5.5.
• Modeli za Copilot hutumia vitambulisho kama copilot/claude-sonnet-4.5.

Magpie husoma kitambulisho kilichopo cha wakala inapohitajika na hakikinakili kwenye hifadhi yake ya watoa huduma. Wakala asili anapobadilisha tokeni, Magpie hufuata mchakato wa kuisasisha wa wakala huyo na huandika tokeni iliyobadilishwa mahali ambapo wakala anaitarajia. Kuondoka kwenye akaunti huondoa mtoa huduma husika.

Usajili wa Claude unahitaji faili halisi ya ndani ya claude iwe imesakinishwa na kuingiliwa. Magpie huendesha faili hiyo na kuunganisha zana za mpigaji kwenye zamu hai kupitia MCP. Usaidizi wa kuingia kwa Google wa Gemini CLI umepangwa lakini kwa sasa haupatikani kama mtoa huduma wa pamoja.

Unganisha Programu Nyingine na Lango

Lango la Magpie husikiliza kwenye 127.0.0.1:3425 kwa chaguo-msingi na huanza pamoja na programu. Ili kuendesha lango pekee, tumia:

magpie serve

Weka MAGPIE_ADDR ili kubadilisha anwani ya kusikiliza. Kufungamanisha kwa loopback kwa chaguo-msingi hulifanya lango libaki kwenye kompyuta yako.

Miisho ya API Inayotumika

• /v1/chat/completions kwa OpenAI Chat Completions.
• /v1/responses kwa OpenAI Responses.
• /v1/messages kwa Anthropic Messages.
• /v1/messages/count_tokens kwa kuhesabu tokeni za Anthropic.
• /v1beta/models/{model}:generateContent kwa uzalishaji wa Gemini, pamoja na vibadala vya utiririshaji na kuhesabu tokeni.
• /v1/models na /v1beta/models kwa katalogi ya modeli.

Ufunguo wa API unaweza kuwa thamani halisi magpie; thamani yoyote inafanya kazi kwa sababu lango husikiliza kwenye loopback kwa chaguo-msingi. Bainisha modeli kila mara kama provider/model.

Mazingira Yanayooana na OpenAI

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

Mazingira Yanayooana na Anthropic

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

Mazingira Yanayooana na Gemini

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

Kichupo cha Gateway katika programu ya kompyuta hutoa mipangilio na vijisehemu vinavyoweza kunakiliwa kwa shell, curl, Python, na Node. Pia huonyesha vitambulisho vya modeli na miito ya hivi karibuni.

Onyesha Upya Katalogi za Modeli

Magpie hupata orodha halisi za modeli kutoka kwa watoa huduma waliowekwa. Katalogi ya models.dev hutoa majina, viwango vya kufikiri, na orodha mbadala kwa watoa huduma ambao hawachapishi katalogi zao wenyewe.

Endesha usawazishaji kamili unapotaka kuonyesha upya data ya models.dev na orodha zote za moja kwa moja za watoa huduma:

magpie sync

Katika kiolesura cha terminali, bonyeza S kwa kitendo hicho hicho. Unaweza pia kuonyesha upya mtoa huduma mmoja tu kwa kutumia magpie provider models PROVIDER.

Ingiza Viungo vya Watoa Huduma kwa Usalama

Wauzaji na relay zinaweza kusambaza ufafanuzi wa watoa huduma uliokwisha jazwa kupitia viungo vya uingizaji. Magpie huonyesha jina la mtoa huduma lililopendekezwa, ncha za huduma, wapangishaji lengwa na miundo kabla ya kuhifadhi chochote.

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

Kiungo maalum cha relay kinaweza kujumuisha ncha tofauti za OpenAI na 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

Hakuna kinachohifadhiwa hadi mtumiaji athibitishe uingizaji. Kurasa za wavuti zinaweza kutumia https://usemagpie.ai/import# ikifuatiwa na vigezo hivyo hivyo. Kwa kuwa thamani hubaki katika sehemu ya fragment ya URL, vivinjari havizitumii kwa seva ya tovuti. Tazama mwongozo wa uingizaji wa Magpie kwa marejeo kamili ya vigezo na zana ya kuunda viungo.

Vidokezo vya Juu

Punguza Miundo Inayoonyeshwa

Si lazima uonyeshe kila modeli inayorejeshwa na mtoa huduma. Chagua tu miundo unayotaka ionekane katika vichaguaji vya mawakala. Hii hurahisisha kudhibiti katalogi kubwa na kusaidia kuzuia kuchagua modeli kimakosa.

Kagua Tafsiri ya Lango

Washa kumbukumbu za utatuzi ili kuona kile ambacho lango linatafsiri:

MAGPIE_DEBUG=1 magpie serve

Maombi hupitishwa moja kwa moja wakati muuzaji tayari anatumia API ya mwombaji. Vinginevyo, Magpie hutafsiri ombi na jibu huku ikihifadhi utiririshaji, mwito wa zana na tabia ya kufikiri inayotumika.

Jua Data Inapohifadhiwa

• ~/.config/magpie/profiles.json huhifadhi profaili zilizohifadhiwa.
• ~/.config/magpie/providers.json huhifadhi watoa huduma na funguo zao kwa hali ya faili 0600.
• ~/.config/magpie/stash.json huhifadhi thamani zilizobadilishwa ili ziweze kurejeshwa.
• ~/.cache/magpie/models.json huhifadhi katalogi ya models.dev.
• ~/.cache/magpie/models/<provider>.json huhifadhi orodha za miundo zilizopatikana kutoka kwa watoa huduma.

Magpie huzingatia XDG_CONFIG_HOME na XDG_CACHE_HOME.

Tumia Mazingira ya Nyumbani ya Maendeleo Yaliyotengwa

Wachangiaji wanaweza kuendesha toleo la maendeleo bila kugusa usanidi wao wa kawaida wa mawakala:

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

make dev hutoa kiolesura moja kwa moja kutoka internal/gui/assets na kukipakia upya wakati faili za mbele zinapobadilika. Lango lake hutumia DEV_ADDR, likiwa na chaguo-msingi la 127.0.0.1:3426, hivyo linaweza kuendeshwa sambamba na mfano wa kawaida wa Magpie. Weka MAGPIE_THEME=light au MAGPIE_THEME=dark ili kulazimisha rangi fulani.

Hitimisho

Magpie hubadilisha usanidi uliotawanyika wa miundo kuwa mtiririko mmoja thabiti wa kazi. Baada ya kukisakinisha, ongeza mtoa huduma au tumia usajili wa wakala uliopo, chagua miundo kwa kila wakala, na uhifadhi michanganyiko muhimu kama profaili. Lango lake la ndani pia huruhusu zana nyingine zinazooana na OpenAI, Anthropic na Gemini kushiriki katalogi hiyo hiyo ya watoa huduma bila kuhifadhi vitambulisho vya wauzaji katika kila programu.