Pi Agent ইনস্টল, কনফিগারেশন ও প্রথম কথোপকথনের টিউটোরিয়াল

pi ইনস্টল করা জটিল নয়, একটি কমান্ডই যথেষ্ট। আগে শুধু认证 পদ্ধতিটি ঠিক করে নিন: বিদ্যমান সাবস্ক্রিপশন ব্যবহার করবেন, নাকি API Key? নিচে ইনস্টলেশন,认证 এবং প্রথম কথোপকথন একসঙ্গে দেখানো হয়েছে।

মূল ধারণা: দুই ধরনের认证 পদ্ধতি

pi ইনস্টল করার পর কাজ করার জন্য কোনো LLM পরিষেবা প্রদানকারীর পরিচয়পত্র দরকার।认证-এর দুটি পথ আছে, আর এই নিবন্ধে বোঝার মতো মূল পার্থক্য এটিই:

• সাবস্ক্রিপশন লগইন (/login)｜API Key

• কী ব্যবহার করবেন｜Claude Pro/Max, ChatGPT Plus/Pro ইত্যাদি সাবস্ক্রিপশন｜পরিষেবা প্রদানকারীর দেওয়া API Key

• বিলিং｜জটিল (সাবস্ক্রিপশন সীমা + সম্ভাব্য অতিরিক্ত ব্যবহার)｜টোকেন অনুযায়ী, যত ব্যবহার তত খরচ

• পরিচয়পত্র কোথায় সংরক্ষিত হয়｜~/.pi/agent/auth.json (OAuth token, স্বয়ংক্রিয়ভাবে রিফ্রেশ হয়)｜environment variable অথবা auth.json

• কার জন্য উপযোগী｜যাদের সাবস্ক্রিপশন আছে এবং আলাদাভাবে Key পরিচালনা করতে চান না｜যারা খরচ নির্ভুলভাবে নিয়ন্ত্রণ করতে চান

একটি কথা মনে রাখুন: Anthropic সাবস্ক্রিপশন লগইন (Claude Pro/Max) তৃতীয় পক্ষের harness চ্যানেলের মাধ্যমে চলে এবং টোকেন অনুযায়ী বিল হয়; এটি সাবস্ক্রিপশন প্যাকেজের সীমা ব্যবহার করে না। pi সতর্কবার্তা দেখাবে, এটি স্বাভাবিক। সম্পূর্ণ নিয়ন্ত্রণ এবং যেকোনো সময় খরচ দেখার সুবিধার জন্য API Key বেশি সুবিধাজনক।

হাতে-কলমে ব্যবহার

1. pi ইনস্টল করুন

pi Node.js-এর ওপর চলে, 22.19.0 বা তার বেশি সংস্করণ প্রয়োজন। প্রথমে node --version দিয়ে নিশ্চিত করুন। দুটি পদ্ধতির যেকোনো একটি বেছে নিন:

# npm দিয়ে গ্লোবাল ইনস্টল (--ignore-scripts নির্ভরতার স্ক্রিপ্ট এড়িয়ে যায়, বেশি নিরাপদ)
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# অথবা curl ইনস্টলার ব্যবহার করুন (Node ইনস্টল না থাকলে এটি ইনস্টল করে দেবে)
curl -fsSL https://pi.dev/install.sh | sh

ইনস্টল শেষে pi --version দিয়ে যাচাই করুন। আনইনস্টলের জন্য npm uninstall -g @earendil-works/pi-coding-agent ব্যবহার করুন।

2.认证 কনফিগার করুন

পদ্ধতি এক: API Key (প্রস্তাবিত)। Key-টি environment variable হিসেবে সেট করুন:

export ANTHROPIC_API_KEY=sk-ant-...
pi

অথবা pi-তে /login চালিয়ে একটি API Key provider বেছে নিন এবং Key-টি ~/.pi/agent/auth.json ফাইলে সংরক্ষণ করুন (0600 অনুমতি, শুধু আপনিই পড়তে ও লিখতে পারবেন)। প্রচলিত পরিষেবা প্রদানকারীদের environment variable:

• পরিষেবা প্রদানকারী｜Environment variable

• Anthropic｜ANTHROPIC_API_KEY

• OpenAI｜OPENAI_API_KEY

• DeepSeek｜DEEPSEEK_API_KEY

• Google Gemini｜GEMINI_API_KEY

• Groq｜GROQ_API_KEY

• xAI｜XAI_API_KEY

• OpenRouter｜OPENROUTER_API_KEY

সম্পূর্ণ তালিকায় কয়েক ডজন পরিষেবা রয়েছে, অফিসিয়াল Providers ডকুমেন্টেশন[1] দেখুন।

পদ্ধতি দুই: সাবস্ক্রিপশন লগইন। Claude Pro, ChatGPT Plus-এর মতো সাবস্ক্রিপশন থাকলে pi-তে /login চালিয়ে সংশ্লিষ্ট provider বেছে নিন এবং OAuth প্রক্রিয়া সম্পন্ন করুন। token-এর মেয়াদ শেষ হলে pi স্বয়ংক্রিয়ভাবে রিফ্রেশ করবে। উপলভ্য বিকল্প: Claude Pro/Max, ChatGPT Plus/Pro(Codex), GitHub Copilot, xAI, OpenRouter। লগআউট করতে /logout ব্যবহার করুন।

Pi-এর কমিউনিটি সক্রিয়। সর্বশেষ Pi Agent এখন Qwen-এর token plan-ও সমর্থন করে।

মডেল কনফিগার করার পর /model ব্যবহার করে পছন্দের মডেল বেছে নিতে পারবেন।

Pi Agent-এ scoped models নামে একটি ধারণাও আছে।

scoped models-এর উদ্দেশ্য হলো ব্যবহারকারী যেন কয়েকটি মডেলের মধ্যে ctrl + p চেপে দ্রুত পরিবর্তন করতে পারেন। ctrl + l ব্যবহার করেও বেছে নিতে পারেন। সংশ্লিষ্ট কনফিগারেশনটি ~/.pi/agent/settings.json ফাইলের enabledModels ফিল্ডে থাকে।

3. প্রথমবার চালু করুন

প্রজেক্ট ডিরেক্টরিতে গিয়ে চালু করুন:

cd /path/to/your/project
pi

প্রথমবার এমন কোনো প্রজেক্টে প্রবেশ করলে যাতে .pi/ কনফিগারেশন আছে, pi জিজ্ঞেস করবে আপনি এটিকে বিশ্বাস করেন কি না। প্রজেক্ট-স্তরের রিসোর্সে যেকোনো কোড চালাতে সক্ষম এক্সটেনশন থাকতে পারে, তাই pi আপনার অজান্তে সেগুলো লোড হতে দেয় না। বিশ্বাসের সিদ্ধান্ত ~/.pi/agent/trust.json ফাইলে সংরক্ষিত হয়, তাই পরেরবার আর জিজ্ঞেস করবে না।

ইন্টারফেসটি ওপর থেকে নিচে চারটি অংশে বিভক্ত: Header (শর্টকাট/লোড হওয়া রিসোর্স), Messages, Editor (যেখানে টাইপ করবেন, বর্ডারের রং চিন্তার স্তর নির্দেশ করে), Footer (ডিরেক্টরি/সেশন/টোকেন ব্যবহার/খরচ/বর্তমান মডেল)। সরাসরি টাইপ করে Enter চাপুন, যেমন:

এই রিপোজিটরির গঠন দেখে কীভাবে এর চেক চালাতে হয় তা বলুন।

pi ডিফল্টভাবে মডেলকে চারটি টুল দেয়: read、write、edit、bash। আরও তিনটি read-only টুল grep/find/ls ডিফল্টভাবে বন্ধ থাকে। প্রয়োজন হলে --tools দিয়ে চালু করুন। যেমন, pi-কে শুধু পড়ার অনুমতি দিয়ে কোড রিভিউ করতে:

pi --tools read,grep,find,ls -p "এই রিপোজিটরির কোডের মান পর্যালোচনা করুন"

মডেল পরিবর্তন করতে Ctrl+L অথবা /model চাপুন; বের হতে দুবার Ctrl+C অথবা /quit চাপুন; আগের কথোপকথন চালিয়ে যেতে pi -c ব্যবহার করুন।

নীতিটি বুঝুন

认证 নির্ধারণের ক্রম: একই সঙ্গে environment variable, auth.json এবং কমান্ড-লাইন প্যারামিটার কনফিগার করা থাকলে pi কমান্ড-লাইন --api-key > auth.json > environment variable > models.json ক্রমে ব্যবহার করে। সাময়িকভাবে অন্য Key দিয়ে পরীক্ষা করতে সরাসরি pi --api-key xxx চালান, কনফিগারেশন ফাইল পরিবর্তন করতে হবে না।

প্রজেক্টে বিশ্বাস হলো ইনপুট গার্ড, sandbox নয়: এটি শুধু ইন্টার‌্যাক্টিভ স্টার্টআপের সময় ডায়ালগ দেখায়। নন-ইন্টার‌্যাক্টিভ মোডে (pi -p) ডিফল্টভাবে ask ব্যবহার হয়, যা -a/-na দিয়ে পরিবর্তন করা যায়। pi-তে ডিফল্টভাবে কোনো sandbox নেই। মডেল bash পেলে যেকোনো কমান্ড চালাতে পারে। অবিশ্বস্ত রিপোজিটরি পরিচালনার জন্য কনটেইনার আইসোলেশন ব্যবহার করতে হবে, যা পরবর্তী নিরাপত্তা নিবন্ধের বিষয়।

সাধারণ সমস্যা

প্রশ্ন:pi --version চালালে command not found দেখায়, কিন্তু npm বলছে ইনস্টল হয়েছে।
সম্ভবত npm-এর গ্লোবাল bin ডিরেক্টরি PATH-এ নেই।npm prefix -g দিয়ে পথটি দেখে PATH-এ যোগ করুন। nvm ব্যবহারকারীরা nvm use চালাতে ভুলবেন না।

প্রশ্ন: চালু করার সময় Node সংস্করণ খুব পুরোনো দেখায়।
pi-এর জন্য Node 22.19.0+ দরকার। সংস্করণ ম্যানেজার (fnm/mise/nvm) দিয়ে আপগ্রেড করুন, অথবা curl ইনস্টলার দিয়ে ইনস্টল করান।

প্রশ্ন: Claude Pro লগইন করার পর প্রতিবার অতিরিক্ত ব্যবহারের সতর্কবার্তা দেখায়।
Anthropic সাবস্ক্রিপশন তৃতীয় পক্ষের চ্যানেলে টোকেন অনুযায়ী বিল হয়। সতর্কবার্তা বন্ধ করতে ~/.pi/agent/settings.json ফাইলে যোগ করুন:

{ "warnings": { "anthropicExtraUsage":false } }

প্রশ্ন: Shift+Enter দিয়ে নতুন লাইন করা যাচ্ছে না।
pi সংশোধক কী শনাক্ত করতে Kitty keyboard protocol ব্যবহার করে। iTerm2, Kitty, Ghostty-তে কোনো কনফিগারেশন ছাড়াই কাজ করে, আর VS Code 1.109.5+ ডিফল্টভাবে সমর্থন করে। Windows Terminal, WezTerm, Alacritty-তে কী ফরোয়ার্ড করার জন্য হাতে একটি কনফিগারেশন লাইন যোগ করতে হবে। টার্মিনাল কনফিগারেশন ডকুমেন্টেশন[2] দেখুন।

প্রশ্ন: সম্পূর্ণ অফলাইনে থাকতে চাই, pi.dev-এ আপডেট পরীক্ষা করতে চাই না।
PI_OFFLINE=1 দিয়ে স্টার্টআপের সময়ের সব নেটওয়ার্ক অপারেশন বন্ধ করুন। শুধু সংস্করণ পরীক্ষা বন্ধ করতে PI_SKIP_VERSION_CHECK=1 ব্যবহার করুন।

তথ্যসূত্র

• • Pi দ্রুত শুরু করার ডকুমেন্টেশন[3]

• • Pi Providers ডকুমেন্টেশন[1] - সব Provider, environment variable ও ক্লাউড প্রদানকারীর কনফিগারেশন

• • Pi Custom Models ডকুমেন্টেশন[4] - models.json দিয়ে কাস্টম Provider

• • Pi Settings ডকুমেন্টেশন[5]

• • Pi Terminal Setup[2] - বিভিন্ন টার্মিনালের কী কনফিগারেশন

• • Pi GitHub রিপোজিটরি[6]

উদ্ধৃত লিংক

[1] অফিসিয়াল Providers ডকুমেন্টেশন: https://pi.dev/docs/latest/providers
[2] টার্মিনাল কনফিগারেশন ডকুমেন্টেশন: https://pi.dev/docs/latest/terminal-setup
[3] Pi দ্রুত শুরু করার ডকুমেন্টেশন: https://pi.dev/docs/latest/quickstart
[4] Pi Custom Models ডকুমেন্টেশন: https://pi.dev/docs/latest/models
[5] Pi Settings ডকুমেন্টেশন: https://pi.dev/docs/latest/settings
[6] Pi GitHub রিপোজিটরি: https://github.com/earendil-works/pi