Magpie দিয়ে AI এজেন্টের মডেল ও প্রোভাইডার পরিচালনা করুন

Magpie কী করে

Magpie আপনার কম্পিউটারে ইনস্টল করা AI এজেন্টগুলোর ব্যবহৃত মডেল দেখার ও পরিবর্তন করার জন্য একটি একক স্থান দেয়। এটি মেনু বার অ্যাপ্লিকেশন, সাধারণ ডেস্কটপ উইন্ডো, টার্মিনাল ইউজার ইন্টারফেস এবং কমান্ড-লাইন টুল হিসেবে পাওয়া যায়।

একাধিক JSON, TOML, YAML এবং environment ফাইল হাতে সম্পাদনা করার পরিবর্তে, আপনি একটি এজেন্ট নির্বাচন করে একটি ফিল্ড বেছে নিয়ে একটি মডেল নির্ধারণ করতে পারেন। Magpie শুধু প্রাসঙ্গিক সেটিং পরিবর্তন করে এবং যেখানে প্রযোজ্য সেখানে মন্তব্য, ক্রম ও ইন্ডেন্টেশন অপরিবর্তিত রাখে। এর লেখার কাজগুলো atomic।

Magpie বর্তমানে Claude Code, Codex, Gemini CLI, OpenCode, Pi, Goose, Cursor CLI, Copilot CLI এবং Crush শনাক্ত করে। শুধু ইনস্টল করা বা কনফিগার করা এজেন্টগুলোই এর ইন্টারফেসে দেখা যায়।

প্রধান বৈশিষ্ট্য

• একাধিক ইন্টারফেস: ডেস্কটপ অ্যাপ্লিকেশন, মেনু বার প্যানেল, টার্মিনাল UI অথবা সাধারণ CLI ব্যবহার করুন।
• নির্দিষ্ট কনফিগারেশন সম্পাদনা: Magpie এজেন্টের বাকি কনফিগারেশন পুনর্লিখন না করে নির্বাচিত কী পরিবর্তন করে।
• একীভূত লোকাল গেটওয়ে: একটি একক loopback endpoint-এর মাধ্যমে এজেন্টগুলো একাধিক vendor-এর মডেল ব্যবহার করতে পারে।
• API অনুবাদ: গেটওয়ে OpenAI Chat Completions, OpenAI Responses, Anthropic Messages এবং Google Gemini-সামঞ্জস্যপূর্ণ request সমর্থন করে, streaming ও tool call-সহ।
• শেয়ার করা সাবস্ক্রিপশন: বিদ্যমান Claude Code, Codex এবং Copilot sign-in অন্য এজেন্টগুলোর provider হিসেবে দেখা যেতে পারে।
• লাইভ মডেল ক্যাটালগ: Magpie provider-গুলো থেকে মডেলের তালিকা সংগ্রহ করে এবং models.dev-এর তথ্য দিয়ে তা সম্পূরক করে।
• Provider preset: Anthropic, OpenAI, Gemini, DeepSeek, Kimi, GLM, MiniMax, Qwen, Mistral, Groq, xAI, OpenRouter, Together, Ollama এবং LM Studio-সহ বিভিন্ন vendor ও service-এর জন্য preset পাওয়া যায়।
• প্রোফাইল: বর্তমান সব এজেন্ট সেটিং একটি নামের অধীনে সংরক্ষণ করুন এবং পরে একসঙ্গে পুনরুদ্ধার করুন।
• ছোট native build: ডেস্কটপ build ব্রাউজার runtime বান্ডেল করার পরিবর্তে অপারেটিং সিস্টেমের webview ব্যবহার করে।

Magpie ইনস্টল করুন

আগে থেকে তৈরি release ইনস্টল করুন

usemagpie.ai থেকে macOS, Windows অথবা Linux-এর জন্য ডেস্কটপ অ্যাপ্লিকেশন ডাউনলোড করুন। আপনি ইনস্টলেশন script-ও চালাতে পারেন:

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

Linux-এ WebKitGTK 4.1 পাওয়া গেলে installer ডেস্কটপ অ্যাপ্লিকেশন নির্বাচন করে, অন্যথায় command-line build ইনস্টল করে। macOS release-গুলো signed ও notarized। Windows এবং Linux build বর্তমানে signed নয়, তাই প্রথমবার চালু করার সময় Windows SmartScreen সতর্কতা দেখাতে পারে।

Magpie পেছনে থেকে update পরীক্ষা করে। ডেস্কটপ অ্যাপ্লিকেশন restart বা quit করার সময় update ইনস্টল করে, আর টার্মিনাল ব্যবহারকারীরা সরাসরি update করতে পারেন:

magpie update

Go source থেকে ইনস্টল করুন

Go ইনস্টল করা থাকলে সরাসরি সর্বশেষ version ইনস্টল করুন:

go install github.com/yetone/magpie@latest

Repository স্থানীয়ভাবে build করুন

Repository-তে বেশ কয়েকটি Make target রয়েছে:

make build            # ডেস্কটপ অ্যাপ্লিকেশন binary
make app              # macOS মেনু বার অ্যাপ্লিকেশন
make cli              # cgo ছাড়া শুধু টার্মিনাল build
make release          # Native app এবং cross-platform CLI build
make release-windows  # Windows amd64 এবং arm64 অ্যাপ্লিকেশন build
make release-linux    # বর্তমান architecture-এর জন্য Linux অ্যাপ্লিকেশন

Linux ডেস্কটপ অ্যাপ্লিকেশন build করতে libgtk-3-dev এবং libwebkit2gtk-4.1-dev প্রয়োজন। সাধারণ Go build-এ gtk3 build tag ব্যবহার করতে হবে। Windows অপারেটিং সিস্টেমের সঙ্গে অন্তর্ভুক্ত WebView2 runtime ব্যবহার করে।

ইন্টারফেস খুলুন

আপনার কাজের ধরন অনুযায়ী উপযুক্ত ইন্টারফেস বেছে নিন:

magpie          # একটি window এবং মেনু বার icon খুলুন
magpie tray     # শুধু মেনু বার icon চালান
magpie tui      # টার্মিনাল ইন্টারফেস খুলুন
magpie ls       # শনাক্ত করা এজেন্ট এবং বর্তমান সেটিং তালিকাভুক্ত করুন

ডেস্কটপ ইন্টারফেসে যেকোনো বর্তমান value-তে click করলে একটি filtered picker খোলে। অনুসন্ধানের জন্য টাইপ করুন অথবা custom value লিখুন, এবং picker বন্ধ করতে esc চাপুন।

টার্মিনাল ইন্টারফেসে arrow key ব্যবহার করে একটি agent ও field নির্বাচন করুন, তার picker খুলতে Enter চাপুন, এবং উপলব্ধ choice filter করতে টাইপ করুন। বন্ধ করতে q চাপুন।

একটি মডেল provider যোগ করুন

উপলব্ধ preset দেখুন

Magpie ইতিমধ্যে যেসব provider চেনে, সেগুলোর তালিকা দিয়ে শুরু করুন:

magpie presets

Preset-গুলো vendor, relay এবং local service অনুযায়ী সাজানো। Hosted preset-এর সাধারণত শুধু একটি API key প্রয়োজন:

magpie provider add deepseek sk-…

Ollama-এর মতো local provider-এর জন্য key প্রয়োজন হয় না:

magpie provider add ollama

Magpie আপনার shell environment থেকে provider key পড়ে না। পরিবর্তে অ্যাপ্লিকেশন বা provider command-এর মাধ্যমে সেগুলো যোগ করুন।

একটি custom OpenAI-compatible provider যোগ করুন

একটি custom provider-এর নাম, base URL, key এবং নির্দিষ্ট model list দিয়ে কনফিগার করা যায়:

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

Custom provider-এ OpenAI-compatible base-এর জন্য url=, Anthropic-compatible base-এর জন্য anthropic=, অথবা দুটিই ব্যবহার করা যায়। Provider-এর আলাদা Responses endpoint থাকলে responses= ব্যবহার করুন। ঐচ্ছিক catalog= argument কোনো models.dev provider থেকে metadata নিতে পারে।

Provider দেখুন ও পরীক্ষা করুন

Provider পর্যালোচনা, model list refresh, API পরীক্ষা, key পরিবর্তন অথবা কোনো entry সরাতে এই command-গুলো ব্যবহার করুন:

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 পরীক্ষা এবং agent-দের মডেল বরাদ্দ করার সমতুল্য নিয়ন্ত্রণ পাওয়া যায়।

Agent-এর মডেল পরিবর্তন

গেটওয়ের মাধ্যমে উন্মুক্ত মডেলগুলোর ফরম্যাট হলো provider/model। Native agent মডেলগুলোও তাদের প্রচলিত নাম দিয়ে নির্বাচন করা যায়।

মৌলিক 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

Agent-এর নামের ক্ষেত্রে cc, oc এবং gem-এর মতো prefix ব্যবহার করা যায়। OpenCode, Pi, Goose এবং Crush-সহ provider-ভিত্তিক agent-গুলো provider/model identifier ব্যবহার করে।

Claude Code-এর টিয়ার কনফিগার করা

Claude Code opus, sonnet, haiku এবং fable-এর মতো টিয়ারগুলোর জন্য আলাদা মডেল নির্ধারণ করতে পারে। উদাহরণস্বরূপ, শুধু haiku টিয়ারে একটি DeepSeek মডেল বরাদ্দ করুন:

magpie claude haiku deepseek/deepseek-v4-flash

টিয়ার-নির্দিষ্ট নির্বাচন মুছে সেটিকে Claude Code-এর প্রধান মডেলে ফিরিয়ে দিন:

magpie claude haiku ""

কোনো গেটওয়ে মডেল নির্বাচন করা হলে, Magpie Claude Code-এর settings.json-এ Anthropic base URL, token এবং model ভেরিয়েবল পরিচালনা করে। Native মডেল নির্বাচন করলে Magpie-এর gateway সেটিংস সরিয়ে আগের মানগুলো পুনরুদ্ধার করা হয়।

পরিবর্তনের পর Agent পুনরায় চালু করা

Agent চালু হওয়ার সময় কনফিগারেশন পড়ে। ইতিমধ্যে চলমান session নতুন session শুরু না করা পর্যন্ত আগের মডেল ব্যবহার করতে থাকে।

Codex-এর ক্ষেত্রে এটি বিশেষভাবে গুরুত্বপূর্ণ, কারণ এটি চালুর সময় মডেল catalog পড়ে এবং পরিবর্তনের পর পুনরায় চালু করতে হয়।

প্রোফাইল সংরক্ষণ ও পুনরুদ্ধার

একটি profile শনাক্ত হওয়া প্রতিটি agent-এর বর্তমান সেটিংস সংরক্ষণ করে। কাজ, পরীক্ষা-নিরীক্ষা, local inference বা খরচ-সাশ্রয়ী কাজের জন্য আলাদা কনফিগারেশন বজায় রাখতে এটি উপযোগী।

magpie save work
magpie use work
magpie profiles
magpie rm work

ডেস্কটপ অ্যাপ্লিকেশনে, প্রধান ভিউয়ের নিচে profile-গুলো chip হিসেবে দেখা যায়। কোনো chip-এ ক্লিক করে সেটি প্রয়োগ করুন, মুছে ফেলতে তার delete নিয়ন্ত্রণ ব্যবহার করুন, অথবা profile তৈরি করতে + save current নির্বাচন করুন।

টার্মিনাল ইন্টারফেসে, বর্তমান সেটআপ সংরক্ষণ করতে s এবং profile প্রয়োগ বা মুছতে p চাপুন।

সাইন-ইন করা Agent-কে Provider হিসেবে ব্যবহার

Magpie বিদ্যমান Claude Code, Codex এবং Copilot subscription-কে provider হিসেবে উন্মুক্ত করতে পারে। মূল agent-এর মাধ্যমে সাইন ইন করার পর, উপলভ্য মডেলগুলো magpie providers এবং অন্যান্য agent-এর model picker-এ দেখা যায়।

• Claude Code মডেল claude/claude-sonnet-5-এর মতো identifier ব্যবহার করে।
• Codex subscription মডেল codex/gpt-5.5-এর মতো identifier ব্যবহার করে।
• Copilot মডেল copilot/claude-sonnet-4.5-এর মতো identifier ব্যবহার করে।

প্রয়োজন হলে Magpie agent-এর বিদ্যমান credential পড়ে এবং সেগুলো নিজস্ব provider store-এ কপি করে না। মূল agent token পরিবর্তন করলে, Magpie সেই agent-এর refresh প্রক্রিয়া অনুসরণ করে এবং agent যেখানে প্রত্যাশা করে সেখানেই পরিবর্তিত token লিখে। সাইন-আউট করলে সংশ্লিষ্ট provider সরিয়ে দেওয়া হয়।

Claude subscription-এর জন্য আসল স্থানীয় claude binary ইনস্টল ও সাইন ইন করা থাকতে হবে। Magpie ওই binary চালায় এবং MCP-এর মাধ্যমে caller tool-গুলোকে চলমান turn-এ যুক্ত করে। Gemini CLI Google login সমর্থন পরিকল্পনাধীন, তবে বর্তমানে shared provider হিসেবে উপলভ্য নয়।

অন্যান্য অ্যাপ্লিকেশনকে গেটওয়ের সঙ্গে সংযুক্ত করা

Magpie-এর gateway ডিফল্টভাবে 127.0.0.1:3425-এ শোনে এবং অ্যাপ্লিকেশনের সঙ্গে চালু হয়। শুধু gateway চালাতে ব্যবহার করুন:

magpie serve

শোনার address পরিবর্তন করতে MAGPIE_ADDR সেট করুন। ডিফল্ট loopback binding gateway-কে আপনার কম্পিউটারের মধ্যেই সীমাবদ্ধ রাখে।

সমর্থিত API Endpoint

• OpenAI Chat Completions-এর জন্য /v1/chat/completions।
• OpenAI Responses-এর জন্য /v1/responses।
• Anthropic Messages-এর জন্য /v1/messages।
• Anthropic token counting-এর জন্য /v1/messages/count_tokens।
• Gemini generation-এর জন্য /v1beta/models/{model}:generateContent, streaming এবং token-counting variant-সহ।
• Model catalog-এর জন্য /v1/models এবং /v1beta/models।

API key হিসেবে আক্ষরিক মান magpie ব্যবহার করা যায়; gateway ডিফল্টভাবে loopback-এ শোনে বলে যেকোনো মান কাজ করবে। মডেল সবসময় provider/model হিসেবে নির্দিষ্ট করুন।

OpenAI-সামঞ্জস্যপূর্ণ Environment

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

Anthropic-সামঞ্জস্যপূর্ণ Environment

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

Gemini-সামঞ্জস্যপূর্ণ Environment

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

ডেস্কটপ অ্যাপ্লিকেশনের Gateway ট্যাবে shell, curl, Python এবং Node-এর জন্য কপি করার মতো সেটিংস ও snippet রয়েছে। এখানে model ID এবং সাম্প্রতিক call-ও দেখা যায়।

Model Catalog রিফ্রেশ করা

কনফিগার করা provider-গুলো থেকে Magpie বাস্তব model list সংগ্রহ করে। models.dev catalog এমন provider-গুলোর জন্য নাম, reasoning level এবং fallback list সরবরাহ করে, যেগুলো নিজেদের catalog প্রকাশ করে না।

models.dev-এর তথ্য এবং সব live provider list রিফ্রেশ করতে পূর্ণ 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 ফ্র্যাগমেন্টে থাকায় ব্রাউজার সেগুলো ওয়েবসাইটের সার্ভারে পাঠায় না। সম্পূর্ণ প্যারামিটার রেফারেন্স ও লিংক বিল্ডারের জন্য 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-সামঞ্জস্যপূর্ণ টুলকেও একই প্রোভাইডার ক্যাটালগ ভাগ করে নিতে দেয়, ফলে প্রতিটি অ্যাপ্লিকেশনে ভেন্ডরের শংসাপত্র সংরক্ষণ করতে হয় না।