Lawula Amamodeli Nabahlinzeki Bama-Agent e-AI nge-Magpie

Lokho okwenziwa yi-Magpie

I-Magpie inikeza indawo eyodwa yokubuka nokushintsha amamodeli asetshenziswa ama-agent e-AI afakwe kukhompyutha yakho. Itholakala njengohlelo lwebha yemenyu, iwindi elivamile ledeskithophu, isixhumi esibonakalayo setheminali, kanye nethuluzi lomugqa womyalo.

Esikhundleni sokuhlela ngesandla amafayela amaningana e-JSON, TOML, YAML, nawemvelo, ungakhetha i-agent, ukhethe inkambu, bese uyinika imodeli. I-Magpie ishintsha kuphela isilungiselelo esifanele, igcine amazwana, ukuhleleka, nokuhlehlisa imigqa lapho kusebenza khona. Ukubhala kwayo kwenziwa ngendlela ye-atomic.

I-Magpie okwamanje ibona i-Claude Code, i-Codex, i-Gemini CLI, i-OpenCode, i-Pi, i-Goose, i-Cursor CLI, i-Copilot CLI, kanye ne-Crush. Ku-interface yayo kuvela kuphela ama-agent afakiwe noma alungiselelwe.

Izici ezibalulekile

• Izixhumi ezibonakalayo eziningi: Sebenzisa uhlelo lwedeskithophu, iphaneli yebha yemenyu, i-UI yetheminali, noma i-CLI ejwayelekile.
• Ukuhlela okunembile kokucushwa: I-Magpie ishintsha ukhiye okhethiwe ngaphandle kokubhala kabusha okunye ukucushwa kwe-agent.
• Isango lendawo elihlanganisiwe: Ama-agent angafinyelela amamodeli avela kubahlinzeki abaningi nge-endpoint eyodwa ye-loopback.
• Ukuhumusha kwama-API: Isango lisekela izicelo ezihambisana ne-OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, kanye ne-Google Gemini, kuhlanganise nokusakaza kanye nezingcingo zamathuluzi.
• Okubhaliselwe okwabiwe: Ukungena okukhona kwe-Claude Code, Codex, ne-Copilot kungavela njengabahlinzeki bamanye ama-agent.
• Amakhathalogi amamodeli abukhoma: I-Magpie ithola uhlu lwamamodeli kubahlinzeki futhi ilugcwalise ngedatha evela ku-models.dev.
• Izilungiselelo ezilungiselelwe zabahlinzeki: Izilungiselelo ziyatholakala kubathengisi nasezinsizeni ezihlanganisa i-Anthropic, OpenAI, Gemini, DeepSeek, Kimi, GLM, MiniMax, Qwen, Mistral, Groq, xAI, OpenRouter, Together, Ollama, kanye ne-LM Studio.
• Amaphrofayela: Londoloza zonke izilungiselelo zamanje zama-agent ngaphansi kwegama bese uzibuyisela ndawonye kamuva.
• Ukwakhiwa komdabu okuncane: Ukwakhiwa kwedeskithophu kusebenzisa i-webview yesistimu yokusebenza esikhundleni sokuhlanganisa i-runtime yesiphequluli.

Faka i-Magpie

Faka ukukhishwa okwakhiwe kusengaphambili

Landa uhlelo lwedeskithophu lwe-macOS, Windows, noma Linux ku-usemagpie.ai. Ungasebenzisa neskripthi sokufaka:

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

Ku-Linux, isifaki sikhetha uhlelo lwedeskithophu uma i-WebKitGTK 4.1 ikhona; uma ingekho sifaka ukwakhiwa komugqa womyalo. Ukukhishwa kwe-macOS kusayiniwe futhi kuqinisekiswe yi-notarization. Ukwakhiwa kwe-Windows ne-Linux okwamanje akusayiniwe, ngakho i-Windows SmartScreen ingabonisa isexwayiso ekuqaliseni kokuqala.

I-Magpie ihlola izibuyekezo ngemuva. Uhlelo lwedeskithophu lufaka isibuyekezo lapho luqala kabusha noma luvalwa, kanti abasebenzisi betheminali bangazibuyekeza ngokusobala:

magpie update

Faka usuka kumthombo we-Go

Uma i-Go ifakiwe, faka inguqulo yakamuva ngokuqondile:

go install github.com/yetone/magpie@latest

Yakha i-repository endaweni

I-repository inikeza ama-target e-Make amaningana:

make build            # I-binary yohlelo lwedeskithophu
make app              # Uhlelo lwebha yemenyu lwe-macOS
make cli              # Ukwakhiwa kwetheminali kuphela ngaphandle kwe-cgo
make release          # Uhlelo lomdabu nokwakhiwa kwe-CLI kwezingxenyekazi eziningi
make release-windows  # Ukwakhiwa kohlelo lwe-Windows amd64 ne-arm64
make release-linux    # Uhlelo lwe-Linux lwezakhiwo zamanje

Ukwakha uhlelo lwedeskithophu lwe-Linux kudinga i-libgtk-3-dev ne-libwebkit2gtk-4.1-dev. Ukwakhiwa okujwayelekile kwe-Go kumele kusebenzise i-build tag ethi gtk3. I-Windows isebenzisa i-runtime ye-WebView2 efakwe nesistimu yokusebenza.

Vula i-interface

Khetha i-interface ehambisana nendlela osebenza ngayo:

magpie          # Vula iwindi nesithonjana sebha yemenyu
magpie tray     # Sebenzisa kuphela isithonjana sebha yemenyu
magpie tui      # Vula i-interface yetheminali
magpie ls       # Bhala ama-agent abonakele nezilungiselelo zamanje

I-interface yedeskithophu ikuvumela ukuthi uchofoze noma yiliphi inani lamanje ukuze uvule isikhethi esihlungiwe. Thayipha ukuze useshe noma ufake inani langokwezifiso, bese ucindezela u-esc ukuvala isikhethi.

Ku-interface yetheminali, sebenzisa okhiye bemicibisholo ukukhetha i-agent nenkambu, cindezela u-Enter ukuvula isikhethi sayo, bese uthayipha ukuhlunga izinketho ezitholakalayo. Cindezela u-q ukuphuma.

Faka umhlinzeki wemodeli

Hlola izilungiselelo ezitholakalayo

Qala ngokubhala abahlinzeki i-Magpie esibaziyo:

magpie presets

Izilungiselelo zihlelwe zaba abathengisi, ama-relay, nezinsizakalo zendawo. Isilungiselelo esisingathwayo ngokuvamile sidinga ukhiye we-API kuphela:

magpie provider add deepseek sk-…

Abahlinzeki bendawo abafana no-Ollama abadingi ukhiye:

magpie provider add ollama

I-Magpie ayifundi okhiye babahlinzeki endaweni yemvelo ye-shell yakho. Bangeze ngohlelo noma ngemiyalo yabahlinzeki.

Faka umhlinzeki wangokwezifiso ohambisana ne-OpenAI

Umhlinzeki wangokwezifiso angalungiselelwa ngegama, i-base URL, ukhiye, kanye nohlu lwamamodeli olucacisiwe:

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

Abahlinzeki bangokwezifiso bangasebenzisa url= njenge-base ehambisana ne-OpenAI, anthropic= njenge-base ehambisana ne-Anthropic, noma kokubili. Sebenzisa responses= uma umhlinzeki ene-endpoint ehlukile ye-Responses. Impikiswano yokuzikhethela ethi catalog= ingaboleka imethadatha kumhlinzeki we-models.dev.

Hlola futhi uhlole abahlinzeki

Sebenzisa le miyalo ukubuyekeza abahlinzeki, ukuvuselela uhlu lwamamodeli, ukuhlola ama-API, ukushintsha okhiye, noma ukususa okufakiwe:

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 yenza isicelo esincane esisodwa ku-API ngayinye esekelwayo bese ibika ukubambezeleka. Kuhlelo lokusebenza lwedeskithophu, ithebhu ethi Providers inikeza izilawuli ezifanayo zokushintsha okhiye, ukukhetha amamodeli aveziwe, ukuhlola abahlinzeki, nokwabela ama-agent amamodeli abo.

Shintsha Amamodeli Ama-Agent

Amamodeli avezwe nge-gateway asebenzisa ifomethi ethi provider/model. Amamodeli omdabu ama-agent nawo angakhethwa ngamagama awo ajwayelekile.

Izibonelo Eziyisisekelo ze-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

Amagama ama-agent amukela iziqalo ezifana no-cc, oc, kanye no-gem. Ama-agent aqondene nomhlinzeki, ahlanganisa i-OpenCode, i-Pi, i-Goose, ne-Crush, asebenzisa izihlonzi ze-provider/model.

Lungiselela Amaleveli e-Claude Code

I-Claude Code ingabela amamodeli ahlukene kumaleveli afana ne-opus, sonnet, haiku, ne-fable. Isibonelo, yabela imodeli ye-DeepSeek kuphela ezingeni le-haiku:

magpie claude haiku deepseek/deepseek-v4-flash

Sula lokho kukhetha okuqondene nalelo zinga ukuze ubuyele kumodeli eyinhloko ye-Claude Code:

magpie claude haiku ""

Lapho kukhethwa imodeli ye-gateway, i-Magpie ilawula i-URL eyisisekelo ye-Anthropic, ithokheni, kanye neziguquko zemodeli ku-settings.json ye-Claude Code. Ukukhetha imodeli yomdabu kususa izilungiselelo ze-gateway ze-Magpie futhi kubuyisele amanani angaphambilini.

Qalisa Kabusha Ama-Agent Ngemva Kokushintsha

Ama-agent afunda ukumiswa kwawo lapho eqala. Iseshini esivele isebenza iyaqhubeka nokusebenzisa imodeli yangaphambilini kuze kube uqala iseshini entsha.

Lokhu kubaluleke kakhulu ku-Codex, efunda ikhathalogi yayo yamamodeli ekuqaleni futhi okufanele iqalwe kabusha ngemva kokushintsha.

Londoloza futhi Buyisela Amaphrofayela

Iphrofayela igcina izilungiselelo zamanje zawo wonke ama-agent atholakele. Lokhu kuyasiza ekugcineni ukumiswa okuhlukile komsebenzi, ukuhlola, ukucubungula kwasendaweni, noma imisebenzi egxile ezindlekweni.

magpie save work
magpie use work
magpie profiles
magpie rm work

Ohlelweni lokusebenza lwedeskithophu, amaphrofayela avela njengama-chip ezansi kokubuka okuyinhloko. Chofoza i-chip ukuze uyisebenzise, sebenzisa isilawuli sayo sokuyisusa ukuze uyisuse, noma khetha + save current ukuze udale iphrofayela.

Ku-interface yetheminali, cindezela u-s ukuze ulondoloze ukumiswa kwamanje bese u-p ukuze usebenzise noma ususe iphrofayela.

Sebenzisa Ama-Agent Angene Ngemvume Njengabahlinzeki

I-Magpie ingaveza okubhaliselwe kwe-Claude Code, Codex, ne-Copilot okukhona njengabahlinzeki. Ngemva kokungena ngemvume nge-agent yokuqala, amamodeli ayo atholakalayo avela ku-magpie providers nakukhethi bamamodeli bamanye ama-agent.

• Amamodeli e-Claude Code asebenzisa izihlonzi ezifana no-claude/claude-sonnet-5.
• Amamodeli okubhaliselwe kwe-Codex asebenzisa izihlonzi ezifana no-codex/gpt-5.5.
• Amamodeli e-Copilot asebenzisa izihlonzi ezifana no-copilot/claude-sonnet-4.5.

I-Magpie ifunda iziqinisekiso ezikhona ze-agent lapho kudingeka futhi ayizikopishi esitolo sayo sabahlinzeki. Uma i-agent yokuqala ishintsha ithokheni, i-Magpie ilandela inqubo yokuvuselela yaleyo agent bese ibhala ithokheni eshintshiwe lapho i-agent ilindele khona. Ukuphuma ngemvume kususa umhlinzeki ohambisanayo.

Okubhaliselwe kwe-Claude kudinga ukuthi i-binary yangempela yasendaweni ye-claude ifakwe futhi kungene ngemvume kuyo. I-Magpie isebenzisa leyo binary futhi ixhumanisa amathuluzi omshayi-ucingo ne-turn esebenzayo nge-MCP. Ukusekelwa kokungena ngemvume kwe-Google kwe-Gemini CLI kuhleliwe kodwa okwamanje akutholakali njengomhlinzeki owabiwe.

Xhuma Ezinye Izinhlelo ku-Gateway

I-gateway ye-Magpie ilalela ku-127.0.0.1:3425 ngokuzenzakalelayo futhi iqala nohlelo lokusebenza. Ukuqalisa i-gateway kuphela, sebenzisa:

magpie serve

Setha i-MAGPIE_ADDR ukuze ushintshe ikheli lokulalela. Ukubophela okuzenzakalelayo kwe-loopback kugcina i-gateway isendaweni kukhompyutha yakho.

Ama-Endpoint e-API Asekelwayo

• /v1/chat/completions ye-OpenAI Chat Completions.
• /v1/responses ye-OpenAI Responses.
• /v1/messages ye-Anthropic Messages.
• /v1/messages/count_tokens yokubala amathokheni e-Anthropic.
• /v1beta/models/{model}:generateContent yokukhiqiza kwe-Gemini, okuhlanganisa izinhlobo zokusakaza nokubala amathokheni.
• /v1/models kanye ne-/v1beta/models yekhathalogi yamamodeli.

Ukhiye we-API ungaba inani langempela elithi magpie; noma yiliphi inani liyasebenza ngoba i-gateway ilalela ku-loopback ngokuzenzakalelayo. Njalo chaza amamodeli njenge-provider/model.

Indawo Ehambisana ne-OpenAI

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

Indawo Ehambisana ne-Anthropic

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

Indawo Ehambisana ne-Gemini

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

Ithebhu ethi Gateway yohlelo lokusebenza lwedeskithophu inikeza izilungiselelo neziqephu ezingakopishwa ze-shell, i-curl, i-Python, ne-Node. Iphinde ibonise izihlonzi zamamodeli nezingcingo zakamuva.

Vuselela Amakhathalogi Amamodeli

I-Magpie ilanda uhlu lwangempela lwamamodeli kubahlinzeki abamisiwe. Ikhathalogi ye-models.dev inikeza amagama, amazinga okucabanga, kanye nohlu lokuwela kuzo kubahlinzeki abangashicileli amakhathalogi abo.

Qalisa ukuvumelanisa okuphelele lapho ufuna ukuvuselela idatha ye-models.dev nawo wonke uhlu lwabahlinzeki abaphilayo:

magpie sync

Esixhumanisini setheminali, cindezela u-S ukuze wenze isenzo esifanayo. Ungaphinda uvuselele umhlinzeki oyedwa kuphela usebenzisa magpie provider models PROVIDER.

Ngenisa Izixhumanisi Zabahlinzeki Ngokuphepha

Abathengisi nama-relay bangasabalalisa izincazelo zabahlinzeki ezigcwaliswe kusengaphambili besebenzisa izixhumanisi zokungenisa. I-Magpie ibonisa igama lomhlinzeki elihlongozwayo, iziphetho, ama-host okuyiwa kuwo, namamodeli ngaphambi kokulondoloza noma yini.

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

Isixhumanisi se-relay yangokwezifiso singafaka iziphetho ezihlukene ze-OpenAI ne-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

Akukho okugcinwayo kuze kube yilapho umsebenzisi eqinisekisa ukungenisa. Amakhasi ewebhu angasebenzisa https://usemagpie.ai/import# alandelwe ngamapharamitha afanayo. Njengoba amanani ehlala engxenyeni ye-URL, iziphequluli aziwathumeli kuseva yewebhusayithi. Bheka umhlahlandlela wokungenisa we-Magpie ukuze uthole inkomba ephelele yamapharamitha kanye nomakhi wezixhumanisi.

Amathiphu Athuthukile

Khawulela Amamodeli Av露ziwe

Akudingeki uveze wonke amamodeli abuyiswa umhlinzeki. Khetha kuphela amamodeli ofuna avele kubakhethi bama-agent. Lokhu kwenza amakhathalogi amakhulu aphathwe kalula futhi kusize ukuvimbela ukukhethwa kwemodeli ngephutha.

Hlola Ukuhumusha Kwe-Gateway

Vumela ukuloga kokulungisa amaphutha ukuze ubone ukuthi i-gateway ihumusha ini:

MAGPIE_DEBUG=1 magpie serve

Izicelo zidlula ngqo lapho umthengisi esekhuluma i-API yomshayi-sicelo. Kungenjalo, i-Magpie ihumusha isicelo nempendulo kuyilapho igcina ukusakaza, ukubizwa kwamathuluzi, nokuziphatha kokucabanga okusekelwayo.

Yazi Lapho Idatha Igcinwa Khona

• ~/.config/magpie/profiles.json igcina amaphrofayela alondoloziwe.
• ~/.config/magpie/providers.json igcina abahlinzeki nezinkinobho zabo ngemodi yefayela engu-0600.
• ~/.config/magpie/stash.json igcina amanani ashintshiwe ukuze abuyiselwe.
• ~/.cache/magpie/models.json igcina ikhathalogi ye-models.dev.
• ~/.cache/magpie/models/<provider>.json igcina uhlu lwamamodeli oluthathwe kubahlinzeki.

I-Magpie ihlonipha XDG_CONFIG_HOME kanye ne-XDG_CACHE_HOME.

Sebenzisa I-Home Yokuthuthukisa Ehlukile

Abanikeli bangasebenzisa i-build yokuthuthukisa ngaphandle kokuthinta izilungiselelo zabo ezijwayelekile zama-agent:

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

make dev inikeza isixhumanisi ngokuqondile isuka ku-internal/gui/assets futhi iyasilayisha kabusha lapho amafayela e-frontend eshintsha. I-gateway yayo isebenzisa DEV_ADDR, ezenzakalelayo ibe ngu-127.0.0.1:3426, ngakho ingasebenza eduze kwesibonelo esijwayelekile se-Magpie. Setha MAGPIE_THEME=light noma MAGPIE_THEME=dark ukuze uphoqe iphalethi.

Isiphetho

I-Magpie ithatha indawo yokucushwa kwamamodeli okusabalele ngokugeleza komsebenzi okukodwa nokungaguquguquki. Ngemva kokuyifaka, engeza umhlinzeki noma usebenzise ukubhalisa kwe-agent okukhona, khetha amamodeli e-agent ngayinye, bese ulondoloza izinhlanganisela eziwusizo njengamaphrofayela. I-gateway yayo yasendaweni ivumela namanye amathuluzi ahambisana ne-OpenAI, Anthropic, ne-Gemini ukuthi abelane ngekhathalogi efanayo yabahlinzeki ngaphandle kokugcina iziqinisekiso zabathengisi kuhlelo lokusebenza ngalunye.