MercaderIA ধাপে ধাপে ইনস্টল করুন
কোনো প্রযুক্তিগত জ্ঞান ছাড়াই। আমরা আপনাকে বলব যে আপনি প্রতিটি মুহূর্তে স্ক্রিনে কী দেখবেন এবং যদি না দেখেন তাহলে কী করবেন। যদি কিছু অদ্ভুত মনে হয়, এটি সাধারণত স্বাভাবিক: আমরা এটি ব্যাখ্যা করব যখন এটি প্রয়োজনীয়।
MercaderIA চারটি অংশের উপর নির্ভর করে। আপনাকে বুঝতে হবে না কীভাবে তারা কাজ করে, শুধু তারা সেখানে আছে তা নিশ্চিত করতে হবে:
- Node.js: যে ইঞ্জিনটি নীচে সরঞ্জামগুলি কাজ করায়।
- Git: এই সরঞ্জামগুলি অভ্যন্তরীণভাবে ব্যবহার করে এমন একটি ইউটিলিটি।
- Claude Code: কৃত্রিম বুদ্ধিমত্তা যা আপনার স্টোরে কাজ করতে চলেছে।
- MercaderIA: এজেন্টিক সিস্টেম যা আপনার সম্পূর্ণ স্টোর স্বয়ংক্রিয় করে।
এই সম্পূর্ণ পৃষ্ঠার সবচেয়ে গুরুত্বপূর্ণ জিনিস
MercaderIA আপনার জন্য Git এবং Claude Code ইনস্টল করে, কিন্তু Node.js আপনাকে আগে ইনস্টল করতে হবে। যদি আপনি এই ক্রমটি এড়িয়ে যান, অ্যাপটি আপনাকে বলবে যে কিছু অনুপস্থিত। ধাপ 1 দিয়ে শুরু করুন।
এটি MercaderIA ডাউনলোড করার আগে। অফিসিয়াল ওয়েবসাইটে যান এবং যে সংস্করণটি LTS বলে তা ডাউনলোড করুন।
Node.js LTS ডাউনলোড করুনLTS মানে 'দীর্ঘ সহায়তা সহ স্থিতিশীল সংস্করণ'। যদি আপনি দুটি বোতাম দেখেন তবে সবসময় LTS বোতাম বেছে নিন, কখনো 'Current' বলা একটি বেছে নবেন না।
এটি ইনস্টল করার সময়: পরবর্তী, পরবর্তী, পরবর্তী। কিছু পরিবর্তন করবেন না, সবকিছু ডিফল্ট স্বীকার করুন।
সমস্ত টার্মিনাল বন্ধ করুন এবং কম্পিউটার পুনরায় চালু করুন
এটি আপনার প্রথমবার Node ইনস্টল করছেন হলে, কম্পিউটার পুনরায় চালু করুন। সিস্টেমটি একটি নতুন প্রোগ্রাম আছে তা 'বুঝতে' সময় নেয়, এবং পুনরায় চালু করা হল সিস্টেমকে জানানোর নিশ্চিত উপায়। এটি সম্পূর্ণ ইনস্টলেশনের সবচেয়ে সাধারণ ত্রুটি এড়ায়।
এটি কাজ করেছে তা যাচাই করুন:
Terminal খুলুন (আমরা ধাপ 2 এ এটি কীভাবে করতে হয় তা ব্যাখ্যা করি) এবং টাইপ করুন:
node --versionএটি v22.14.0 এর মতো কিছু প্রতিক্রিয়া জানাতে হবে। যদি এটি করে, সম্পন্ন।
যদি এটি “command not found: node” বলে, এটি ইনস্টল হয়নি বা আপনি পুনরায় চালু করেননি: পুনরায় চালু করুন এবং আবার চেষ্টা করুন।
টার্মিনাল হল একটি উইন্ডো যেখানে আপনি পাঠ্যে আদেশ লেখেন, Enter চাপেন এবং প্রোগ্রাম আপনাকে উত্তর দেয়। আর কিছু নয়। আপনি কিছু ভেঙে ফেলবেন না।
macOS
- Cmd + স্পেস চাপুন।
- টার্মিনাল টাইপ করুন।
- Enter চাপুন।
Windows
- Windows কী চাপুন।
- powershell টাইপ করুন।
- Windows PowerShell খুলুন।
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
কালো বা নীল উইন্ডো পাঠ্য সহ সম্পূর্ণভাবে স্বাভাবিক: এটি একটি নতুনভাবে খোলা টার্মিনাল কেমন দেখায়।
অনুলিপি এবং পেস্ট করা অনুমতি দেওয়া হয়েছে (এবং সুপারিশ করা হয়)
আপনাকে কিছু ম্যানুয়ালি লিখতে হবে না। এই গাইডের প্রতিটি ব্লক থেকে কপি বোতাম ব্যবহার করুন এবং টার্মিনালে Cmd + V দিয়ে পেস্ট করুন।
ভবিষ্যতের জন্য দরকারী ডেটা: যদি কখনো টার্মিনাল আপনাকে পাসওয়ার্ড দিতে বলে, আপনি লিখতে সময় কিছু দেখা যায় না — কোনো বিন্দু বা তারকা নেই। এটি সুরক্ষা, এটি ভাঙা নয়। MercaderIA এর সাথে এটি আপনার সাথে ঘটবে না, কিন্তু এটি জানা ভালো।
দুটি রাস্তা আছে। উভয় কাজ করে:
বিকল্প A — টার্মিনাল থেকে ম্যানুয়ালি (সুপারিশ করা)
Terminal খুলুন এবং এই লাইনটি পেস্ট করুন:
curl -fsSL https://claude.ai/install.sh | bashবিকল্প B — MercaderIA এটি করতে দিন
প্রথমবার MercaderIA খুলে দিলে, একটি সহায়ক যা অনুপস্থিত তা সনাক্ত করে এবং Git এবং Claude Code স্বয়ংক্রিয়ভাবে ইনস্টল করে। এটি সবচেয়ে সহজ, কিন্তু কখনো কখনো এটি ছড়িয়ে পড়তে সময় নেয় এবং আপনাকে অ্যাপটি বন্ধ এবং পুনরায় খুলতে হয় যাতে এটি এটি চিনতে পারে। কম্পিউটার পুনরায় চালু করা বা কয়েক মিনিট অপেক্ষা করা সবকিছু একা সংযুক্ত করে। এটি শুধুমাত্র শুরুতে ঘটে: সংযুক্ত হওয়ার পরে আর কখনো ঘটবে না।
বেশ অনেক পাঠ্য স্ক্রিনে যাবে। এটি স্বাভাবিক। এটি শেষ হয়েছে যখন লিখার লাইন আবার উপস্থিত হয় ($)।
Claude Code ইনস্টল করার পরে, টার্মিনালে claude টাইপ করুন এবং এটি আপনাকে সাড়া দেয়:
zsh: command not found: claude
শান্ত থাকুন: এটি প্রত্যাশিত, এটি একটি বিরল ত্রুটি নয়। প্রোগ্রামটি সত্যিই ইনস্টল আছে, কিন্তু এটি এমন একটি ফোল্ডারে সংরক্ষিত ছিল যা টার্মিনালের কাছে তার খোঁজার জায়গাগুলির তালিকা নেই। এটি বাড়িতে বই আছে কিন্তু যে তাকে সবসময় তাকান সেখানে নেই এর মতো: আপনাকে কম্পিউটারকে বলতে হবে এটি কোথায় আছে।
macOS — এই দুটি লাইন পেস্ট করুন, একটি অন্যটির পরে:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcপ্রথম ফোল্ডার স্থায়ীভাবে তালিকায় যোগ করে (উদাহরণস্বরূপ /Users/maria/.local/bin)। দ্বিতীয় টার্মিনাল এটি বুঝতে দেয় এখনই, পুনরায় চালু ছাড়াই।
সাথে যাচাই করুন:
claude --versionযদি তা এখনো কাজ না করে, এটি কোনো বড় সমস্যা নয়
MercaderIA অনেক ভিন্ন ফোল্ডারে প্রোগ্রাম খোঁজে এবং সাধারণত এটি খুঁজে পায় যদিও টার্মিনাল এটি না দেখে। এগিয়ে যান এবং অ্যাপটি চেষ্টা করুন।
Claude Code একটি অ্যাকাউন্ট প্রয়োজন। প্রথমবার এটি লগইন করতে বলে: ব্রাউজারের একটি ট্যাব খোলে, আপনি আপনার Claude অ্যাকাউন্টে প্রবেশ করেন, স্বীকার করেন এবং অ্যাপে ফিরে যান।
MercaderIA প্রথমবার Claude Code ইনস্টল শেষ হওয়ার পরে স্বয়ংক্রিয়ভাবে সেই ট্যাবটি খোলে। যদি আপনার আগে Claude ইনস্টল করা থাকে, অ্যাপটি ধরে নেয় আপনি ইতিমধ্যে লগইন করেছেন এবং এটি খোলে না। যদি এটি বেরিয়ে আসে যে আপনি না করেছেন, এটি টার্মিনাল খুলে এবং টাইপ করে সাধারণ করা হয়:
claude…এবং যা স্ক্রিনে উপস্থিত হয় তা অনুসরণ করা।
এটি দুটি ভিন্ন জিনিস, তাদের সাথে মিশ্রিত করবেন না
আপনার একটি সক্রিয় পরিকল্পনা সহ Claude অ্যাকাউন্ট এবং আলাদাভাবে MercaderIA এর একটি লাইসেন্স প্রয়োজন। একটি অন্যটি অন্তর্ভুক্ত করে না।
যদি macOS বলে যে এটি বিকাশকারী যাচাই করতে পারে না
.dmg খুলুন এবং MercaderIA কে অ্যাপ্লিকেশন ফোল্ডারে টেনে আনুন। যদি এটি খোলার সময় সতর্কতা উপস্থিত হয়, MercaderIA এ ডান-ক্লিক করুন অ্যাপ্লিকেশন → খুলুন → খুলুন। এটি বেরিয়ে আসে কারণ অ্যাপটি এখনো Apple দ্বারা স্বাক্ষরিত নয়, এটি কারণ এটি বিপজ্জনক নয়।
আপনি Git, Claude Code এবং Node.js এর একটি তালিকা দেখতে চলেছেন, প্রতিটি তার অবস্থা সহ, এবং অ্যাপটি যা অনুপস্থিত তা নিজে ইনস্টল করছে।
- Node.jsপাওয়া গেছে — v22.14.0
- Gitইনস্টল করছে…
- Claude Codeপাওয়া যায় নি
যদি কিছু ইনস্টল করার পরেও 'পাওয়া যায় নি' হিসাবে উপস্থিত থাকে
MercaderIA সম্পূর্ণভাবে বন্ধ করুন এবং এটি আবার খুলুন। অ্যাপটি চালু হওয়ার মুহূর্তে সিস্টেমের প্রোগ্রাম তালিকা উত্তরাধিকার পায়, তাই যা খোলা থাকার সময় ইনস্টল করা হয় তা পরবর্তী স্টার্টআপ পর্যন্ত এটি দেখে না। এটি একটি ত্রুটি নয়, এটি কীভাবে কাজ করে। একটি কম্পিউটারে যেখানে এর কিছুই কখনো ইনস্টল করা হয়নি, সবকিছু সবুজ হওয়ার আগে অ্যাপটি পুনরায় চালু করতে হবে এক বা দুইবার স্বাভাবিক।
যদি তালিকা হিমায়িত মনে হয়, এটি যাচাই করছে
প্রতিটি প্রোগ্রামের যাচাইকরণ 10 সেকেন্ড পর্যন্ত অপেক্ষা করে। এটি সময় দিন।
অ্যাপটি আপনার স্টোর ঠিকানা এই বিন্যাসে পাবে বলবে:
mitienda.myshopify.comমনোযোগ: এটি সেই ঠিকানা, আপনার স্টোরের সুন্দর ডোমেইন নয়। এটি খুঁজে পেতে, Shopify প্যানেলে যান → সেটিংস → ডোমেইন: আপনার ডোমেইন .myshopify.com সেখানে উপস্থিত হয়, Shopify এর অভ্যন্তরীণ ডোমেইন হিসাবে চিহ্নিত।
তারপর ব্রাউজার অনুমতি অনুরোধ করা একটি Shopify স্ক্রিনের সাথে খোলে। এটি একটি দীর্ঘ তালিকা এবং এটি স্বাভাবিক: সহায়কটিকে পণ্য, অর্ডার, ইনভেন্টরি, শিপিং এবং রিটার্ন পড়তে এবং সম্পাদনা করতে সক্ষম হতে হবে আপনার জন্য কাজ করতে। এটি পর্যালোচনা করুন এবং স্বীকার করুন।
যদি আপনি আগে স্টোর সংযুক্ত করেছেন
অ্যাপটি নতুন সংস্করণ থেকে নতুন অনুমতি যোগ করতে আপনাকে আবার অনুমোদন চেতনতার জন্য জিজ্ঞাসা করতে পারে। এটি প্রত্যাশিত, এটি একটি ত্রুটি নয়।
প্রতিটি পয়েন্ট চিহ্নিত করুন। যদি পাঁচটি আছে, আপনি ইতিমধ্যে আপনার স্টোরের সাথে কথা বলতে শুরু করতে পারেন।
সাধারণ সমস্যা
claude: command not found / 'আদেশ স্বীকৃত নয়'
প্রোগ্রাম ইনস্টল করা হয়েছে কিন্তু টার্মিনাল জানে না কোথায় এটি খুঁজতে হবে। ধাপ 4 (PATH) এর মেরামত প্রয়োগ করুন এবং claude --version দিয়ে আবার চেষ্টা করুন। Windows এ, PowerShell বন্ধ এবং পুনরায় খুলুন।
node: command not found Node ইনস্টল করার পরে
কম্পিউটার পুনরায় চালু করুন। সিস্টেমটি নতুন প্রোগ্রাম নিবন্ধন করতে পুনরায় শুরু প্রয়োজন। তারপর node --version চেষ্টা করুন।
অ্যাপটি বলে যে কিছু অনুপস্থিত যা আমি ইতিমধ্যে ইনস্টল করেছি
MercaderIA সম্পূর্ণভাবে বন্ধ করুন এবং এটি আবার খুলুন। অ্যাপটি স্টার্টআপে পরিবেশ পড়ে; খোলা থাকার সময় ইনস্টল করা কিছু পরবর্তী স্টার্টআপ পর্যন্ত দেখা যায় না।
Shopify অনুমতি স্ক্রিন একটি ত্রুটি দেয়
ট্যাব বন্ধ করুন এবং অ্যাপ থেকে সংযোগ আবার চালু করুন। যদি এটি অব্যাহত থাকে, একটি স্ক্রিনশট সহ আমাদের লিখুন।
macOS আমাকে অ্যাপ খুলতে দেয় না
অ্যাপ্লিকেশনগুলিতে MercaderIA এ ডান-ক্লিক করুন → খুলুন → খুলুন। এটি একটি অস্বাক্ষরিত অ্যাপ সতর্কতা, বাস্তব নিরাপত্তা সমস্যা নয়।
Windows বলে যে প্রোগ্রাম সুরক্ষিত নয়
আরো তথ্য → সব ক্ষেত্রে চালান। SmartScreen নতুন ইনস্টলারদের সেই সতর্কতা দেখায়।
একটি নতুন কম্পিউটারে এটি কিছুই সনাক্ত করে না
এটি স্বাভাবিক কেস। সঠিক ক্রম: Node.js ইনস্টল করুন, কম্পিউটার পুনরায় চালু করুন, MercaderIA খুলুন এবং এটি Git এবং Claude Code ইনস্টল করতে দিন, এবং অ্যাপটি পুনরায় চালু করুন। সবকিছু সবুজ।
আপনি এখনো আটকে আছেন?
আমাদের লিখুন এবং আমরা এটি কাজ করা পর্যন্ত আপনাকে সহায়তা করব। আপনি কোন ধাপে ছিলেন এবং স্ক্রিনে কী উপস্থিত হয়েছে তা আমাদের বলুন (একটি স্ক্রিনশট খুব সাহায্য করে)।
todo@mercaderia.co