Capri টিউটোরিয়াল: Windows AI এজেন্ট দিয়ে ফাইল, প্রজেক্ট ও কোড নিয়ন্ত্রণ করুন

Capri কী?

Capri হলো Windows-এর জন্য তৈরি একটি ওপেন-সোর্স, সাইবারপাঙ্ক-থিমযুক্ত AI এজেন্ট। এটি AI সহকারীর মাধ্যমে ফাইল, প্রজেক্ট ফোল্ডার, কোড, শেল টুল, অ্যাপ্লিকেশন এবং ওয়েব নিয়ে কাজ করার জন্য একটি নেটিভ ডেস্কটপ ইন্টারফেস প্রদান করে। টার্মিনাল কমান্ড লেখার পরিবর্তে, আপনি সাধারণ ভাষায় একটি লক্ষ্য বর্ণনা করেন এবং Capri-কে কাজটি সমন্বয় করতে দেন।

Capri ইন্টারফেস ও টুল স্তর হিসেবে কাজ করে, আর একটি বাহ্যিক সহকারী AI যুক্তি সরবরাহ করে। এটি বিল্ট-ইনভাবে Claude Code, Codex এবং Antigravity সমর্থন করে। কাস্টম অ্যাডাপ্টারের মাধ্যমে অন্যান্য সহকারীকেও সংযুক্ত করা যায়।

Capri হলো সাইবারপাঙ্ক ঘরানা এবং Cyberpunk: Edgerunners থেকে অনুপ্রাণিত একটি স্বাধীন, অনানুষ্ঠানিক ফ্যান প্রজেক্ট। এটি CD PROJEKT RED, Netflix, Studio Trigger, Anthropic, OpenAI বা Google-এর সঙ্গে সম্পৃক্ত নয় এবং তাদের অনুমোদিতও নয়।

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

• একাধিক AI ইঞ্জিন: Claude Code, Codex, Antigravity বা কাস্টম অ্যাডাপ্টারের মাধ্যমে অন্য কোনো সহকারী সংযুক্ত করুন।
• নেটিভ Windows ইন্টারফেস: সরাসরি টার্মিনালে কাজ করার পরিবর্তে ইনস্টল করা ডেস্কটপ অ্যাপ্লিকেশন ব্যবহার করুন।
• ফাইল ও প্রজেক্ট টুল: ফাইল বা সম্পূর্ণ প্রজেক্ট ফোল্ডার খুঁজুন, পড়ুন, সংগঠিত করুন এবং সম্পাদনা করুন।
• এজেন্ট ওয়ার্কফ্লো: Capri কোনো কাজের পরিকল্পনা করতে, টুলের অনুরোধ করতে, ফলাফল যাচাই করতে এবং কী ঘটেছে তা জানাতে পারে।
• কোড সহায়তা: নির্বাচিত ইঞ্জিনকে কোড লেখা, রিফ্যাক্টর, ডিবাগ এবং চালানোর অনুরোধ করুন।
• অনুমোদন নিয়ন্ত্রণ: সংবেদনশীল কাজ পর্যালোচনা করে Capri আপনার সিস্টেমে পরিবর্তন করার আগে অনুমোদন বা প্রত্যাখ্যান করুন।
• কনফিগারযোগ্য সীমা: নির্বাচিত ফোল্ডারে অ্যাক্সেস সীমাবদ্ধ করুন এবং জিজ্ঞাসা, স্বয়ংক্রিয় বা শুধু-পঠন অনুমতির আচরণ বেছে নিন।

প্রয়োজনীয়তা

Capri বর্তমানে Windows 10 বা পরবর্তী সংস্করণ প্রয়োজন। এটি Windows .exe ইনস্টলার হিসেবে বিতরণ করা হয়। macOS ও Linux সংস্করণ প্রজেক্টের রোডম্যাপে রয়েছে, তবে বর্তমানে উপলভ্য নয়।

আপনার নিজস্ব সমর্থিত AI সহকারী অ্যাকাউন্ট বা API কী-ও প্রয়োজন। Capri নিজে MIT License-এর অধীনে ওপেন সোর্স, তবে সংযুক্ত AI প্রদানকারী তার নিজস্ব মূল্যনীতি অনুযায়ী ব্যবহারের জন্য অর্থ নিতে পারে।

Windows-এ Capri ইনস্টল করুন

১. ইনস্টলার ডাউনলোড করুন

সর্বশেষ Capri রিলিজ খুলে Capri-Setup.exe ডাউনলোড করুন। অজানা তৃতীয় পক্ষের ডাউনলোড উৎসের পরিবর্তে অফিসিয়াল রিপোজিটরি রিলিজ পেজ ব্যবহার করুন।

২. সেটআপ উইজার্ড চালান

1. Capri-Setup.exe খুলুন।
2. ইনস্টলেশন উইজার্ডের নির্দেশনা অনুসরণ করুন।
3. ইনস্টলেশনের পর Windows Start মেনু থেকে Capri খুলুন।

Capri একটি নতুন অ্যাপ্লিকেশন হওয়ায় এবং এখনও বড় ডাউনলোড-সুনাম না থাকায় Windows SmartScreen একটি সতর্কতা দেখাতে পারে। আপনি যদি অফিসিয়াল রিলিজ পেজ থেকে ইনস্টলারটি নিয়ে থাকেন, তাহলে চালিয়ে যেতে More info এবং এরপর Run anyway নির্বাচন করুন।

৩. একটি AI ইঞ্জিন সংযুক্ত করুন

প্রথমবার চালু হলে Capri আপনাকে একটি সহকারী নির্বাচন করতে বলবে। Claude Code, Codex, Antigravity বা অন্য কোনো সমর্থিত বিকল্প বেছে নিন, তারপর সাইন ইন করুন বা অনুরোধ করা API কী দিন।

আপনার অনুরোধগুলো আপনার সংযুক্ত সহকারী প্রক্রিয়া করে। তাই ওই প্রক্রিয়াকরণের ক্ষেত্রে প্রদানকারীর শর্তাবলি, গোপনীয়তা নীতি, মূল্যনীতি এবং অ্যাকাউন্টের নিয়ম প্রযোজ্য হবে।

Capri কীভাবে একটি কাজ পরিচালনা করে

1. আপনি লক্ষ্য বর্ণনা করেন: ডেস্কটপ অ্যাপ্লিকেশনে সাধারণ ভাষায় একটি অনুরোধ লিখুন।
2. Capri ইঞ্জিন নির্বাচন করে: অনুরোধটি আপনার কনফিগার করা AI সহকারীর কাছে পাঠানো হয়।
3. ইঞ্জিন একটি পরিকল্পনা তৈরি করে: সহকারী নির্ধারণ করে কোন ধাপ ও টুল প্রয়োজন।
4. Capri সংবেদনশীল কাজ উপস্থাপন করে: আপনার অনুমতির ওপর নির্ভর করে, অনুরোধ করা ফাইল বা সিস্টেম কার্যক্রম পর্যালোচনা করতে পারেন।
5. আপনি অনুমোদন বা প্রত্যাখ্যান করেন: অনুমোদিত কাজ Capri-এর টুল স্তরের মাধ্যমে সম্পন্ন হয়।
6. Capri ফলাফল জানায়: এজেন্ট ফলাফল যাচাই করে এবং কী করেছে তার সংক্ষিপ্তসার দেয়।

মৌলিক ব্যবহারের উদাহরণ

একটি ফোল্ডার সংগঠিত করুন

কোনো ফোল্ডার পরিষ্কার করতে লক্ষ্যস্থল চিহ্নিত করুন এবং কাঙ্ক্ষিত সংগঠন বর্ণনা করুন:

আমার Downloads ফোল্ডারটি পরিষ্কার করে ফাইলগুলো ধরন অনুযায়ী গুচ্ছবদ্ধ করুন। কিছু সরানোর আগে আমাকে পরিকল্পনাটি দেখান।

Capri ফোল্ডারটি স্ক্যান করে একটি পরিকল্পনা প্রস্তাব করতে এবং ফাইল সরানোর আগে অনুমোদনের অনুরোধ করতে পারে। অপারেশনটি গ্রহণ করার আগে গন্তব্য ফোল্ডার ও ফাইলের নাম সাবধানে পর্যালোচনা করুন।

কোড পরীক্ষা করে ঠিক করুন

প্রাসঙ্গিক প্রজেক্ট ফোল্ডার খুলুন বা এতে অ্যাক্সেস দিন, তারপর Capri-কে একটি নির্দিষ্ট অনুরোধ জানান:

এই প্রজেক্টের বাগটি খুঁজে বের করুন, কারণ ব্যাখ্যা করুন, সমাধান প্রয়োগ করুন এবং উপলভ্য যাচাইগুলো চালান।

নির্বাচিত AI ইঞ্জিন কোড পরীক্ষা করতে, সম্ভাব্য সমস্যা শনাক্ত করতে, প্রাসঙ্গিক ফাইল সম্পাদনা করতে এবং যাচাই চালাতে পারে। আরও নিরাপদ পর্যালোচনার জন্য, প্রজেক্টে পরিবর্তন করার অনুমতি দেওয়ার আগে Capri-কে প্রস্তাবিত পরিবর্তন ব্যাখ্যা করতে বলুন।

ডকুমেন্টের সারসংক্ষেপ তৈরি করুন

অনুমোদিত কোনো ফোল্ডারের একাধিক ফাইল নিয়ে Capri কাজ করতে পারে। উদাহরণস্বরূপ:

এই ফোল্ডারের প্রতিটি PDF-এর সারসংক্ষেপ তৈরি করে একটি সম্মিলিত সারসংক্ষেপ ডকুমেন্ট লিখুন।

কাজটি অনুমোদন করার আগে Capri কোন ফোল্ডার পড়বে এবং তৈরি করা ডকুমেন্ট কোথায় সংরক্ষণ করার পরিকল্পনা করছে তা যাচাই করুন।

একটি ওয়েব প্রজেক্ট তৈরি করুন

আপনি একটি সম্পূর্ণ ডেভেলপমেন্ট ওয়ার্কফ্লোর অনুরোধও করতে পারেন:

এই ফোল্ডারে একটি নতুন ওয়েব অ্যাপ সেট আপ করুন, এর নির্ভরতা ইনস্টল করুন এবং এটি চালু করুন।

এই ধরনের অনুরোধে ফাইল তৈরি, প্যাকেজ ডাউনলোড, শেল কমান্ড চালানো এবং একটি প্রসেস চালু করা জড়িত থাকতে পারে। অনুমোদনের আগে প্রস্তাবিত ফ্রেমওয়ার্ক, কমান্ড এবং লক্ষ্য ডিরেক্টরি পরীক্ষা করুন।

অনুমতি ও সীমা কনফিগার করুন

README-তে নিম্নলিখিত উদাহরণ কনফিগারেশন দেওয়া আছে:

engine: claude-code

permissions:
  mode: ask
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

engine-এর মানটি সংযুক্ত সহকারী নির্বাচন করে। নথিভুক্ত মানগুলোর মধ্যে রয়েছে claude-code, codex, antigravity এবং custom।

permissions বিভাগে তিনটি নথিভুক্ত মোড রয়েছে:

• ask: কাজ করার আগে Capri জিজ্ঞাসা করে। এজেন্ট কীভাবে কাজ করে তা শেখার সময় এটি শুরু করার জন্য সবচেয়ে ভালো পদ্ধতি।
• auto: কাজগুলো স্বয়ংক্রিয়ভাবে এগিয়ে যেতে পারে। এটি কেবল তখনই ব্যবহার করুন, যখন আপনি কাজটি বুঝেছেন এবং এর পরিসর কঠোরভাবে সীমিত করেছেন।
• read-only: পরিবর্তনের অনুমতি না দিয়ে পরিদর্শন ও বিশ্লেষণের জন্য Capri ব্যবহার করুন।

allowed_folders তালিকা এজেন্ট কোন কোন অবস্থানে প্রবেশ করতে পারবে তা সীমিত করে। সম্পূর্ণ ড্রাইভ বা ব্যবহারকারী প্রোফাইলের বদলে নির্দিষ্ট কোনো কাজের ডিরেক্টরিতে প্রবেশাধিকার দেওয়াই ভালো।

উন্নত টিপস

স্পষ্ট সীমারেখাসহ প্রম্পট লিখুন

লক্ষ্য ফোল্ডার, কাঙ্ক্ষিত ফলাফল, যাচাইয়ের পদ্ধতি এবং কোন কাজের জন্য নিশ্চিতকরণ প্রয়োজন তা উল্লেখ করুন। নির্দিষ্ট অনুরোধ অস্পষ্টতা কমায়:

Review the project in my Projects folder. Identify the cause of the failing tests, explain your proposed edits, and wait for approval before changing files. After approval, run the existing test suite.

শুরুতে read-only মোড ব্যবহার করুন

অপরিচিত রিপোজিটরি বা নথির সংগ্রহের ক্ষেত্রে read-only প্রবেশাধিকার দিয়ে শুরু করুন। Capri-কে উপকরণ পরিদর্শন করে একটি পরিকল্পনা সুপারিশ করতে বলুন। সম্পাদনার অনুমতি দেওয়ার জন্য প্রস্তুত হলেই কেবল permission mode পরিবর্তন করুন।

আলাদা প্রজেক্ট ফোল্ডার ব্যবহার করুন

পরীক্ষামূলক কাজ একটি নির্দিষ্ট ফোল্ডারে কপি করুন এবং Capri-কে কেবল সেই ডিরেক্টরিতে প্রবেশাধিকার দিন। এতে অনিচ্ছাকৃত পরিবর্তন সীমিত হয় এবং তৈরি হওয়া ফাইলের পার্থক্য পর্যালোচনা করা সহজ হয়।

পরিকল্পনা ও বাস্তবায়ন আলাদা রাখুন

বড় কাজের ক্ষেত্রে প্রথমে কোনো পরিবর্তন ছাড়াই একটি পরিকল্পনা চাইুন। ধাপগুলো পর্যালোচনা করে, অনুমোদিত অংশের জন্যই কেবল অনুমতি দিয়ে দ্বিতীয় নির্দেশনা দিন। ব্যাপক ফাইল অপারেশন, dependency ইনস্টলেশন বা বড় ধরনের refactoring-এর ক্ষেত্রে এটি বিশেষভাবে কার্যকর।

প্রয়োজন অনুযায়ী engine পরিবর্তন করুন

Capri আপনাকে সমর্থিত AI engine-গুলোর মধ্যে বেছে নেওয়ার সুযোগ দেয়। একাধিক সহকারীর অ্যাকাউন্ট থাকলে বর্তমান কাজের জন্য সবচেয়ে উপযুক্তটিকে নির্বাচন করুন। মনে রাখবেন, প্রতিটি provider-এর সক্ষমতা, খরচ এবং গোপনীয়তার শর্ত আলাদা।

custom adapter ব্যবহারে সতর্ক থাকুন

custom adapter-এর মাধ্যমে অন্যান্য সহকারীকে সংযুক্ত করা যায়। এটি ব্যবহার করার সময় credential, request, tool call এবং ফেরত আসা data কীভাবে পরিচালনা করা হয় তা যাচাই করুন। README-তে adapter বাস্তবায়নের নির্দেশনা নেই, তাই integration তৈরির আগে প্রকল্পের বর্তমান documentation বা contribution resource দেখুন।

রোডম্যাপের প্রতিটি বৈশিষ্ট্য উপলব্ধ ধরে নেবেন না

রোডম্যাপে plugin system, voice control, task scheduler, theme gallery এবং macOS ও Linux version-কে সম্পন্ন নয়, বরং পরিকল্পিত হিসেবে তালিকাভুক্ত করা হয়েছে। ওই বৈশিষ্ট্যগুলোর ওপর workflow তৈরি করার আগে সর্বশেষ release notes দেখুন।

নিরাপত্তা নির্দেশিকা

• প্রতিটি সংবেদনশীল কাজ পর্যালোচনা করুন: মুছে ফেলা, সরানো, প্রতিস্থাপন, shell command এবং dependency ইনস্টলেশনের দিকে বিশেষ নজর দিন।
• ফোল্ডারে প্রবেশাধিকার সীমিত রাখুন: বর্তমান কাজের জন্য প্রয়োজনীয় ফাইলগুলোতেই প্রবেশাধিকার দিন।
• ব্যাকআপ রাখুন: ব্যাপক সংগঠন, স্বয়ংক্রিয় সম্পাদনা বা অন্য বড় কাজের আগে গুরুত্বপূর্ণ data-এর ব্যাকআপ নিন।
• credential সুরক্ষিত রাখুন: API key, account token বা অন্য কোনো গোপন তথ্য কখনো শেয়ার করবেন না।
• তৈরি করা command যাচাই করুন: Capri-কে চালানোর অনুমতি দেওয়ার আগে shell command-টি বুঝে নিন।
• version control ব্যবহার করুন: code project-এর ক্ষেত্রে উল্লেখযোগ্য সম্পাদনার অনুরোধের আগে বর্তমান অবস্থা commit করুন বা অন্যভাবে সংরক্ষণ করুন।

কোনো নিরাপত্তা সমস্যা আবিষ্কার করলে প্রকল্পের নিরাপত্তা প্রতিবেদন দাখিলের নির্দেশনা অনুসরণ করে ব্যক্তিগতভাবে জানিয়ে দিন।

সমস্যা সমাধান ও প্রকল্পের resource

installer, engine connection বা agent workflow প্রত্যাশামতো কাজ না করলে Capri GitHub repository এবং সর্বশেষ release notes দেখুন। bug ও feature idea project issue form-এর মাধ্যমে জমা দেওয়া যায়।

bug report, documentation, theme, feature proposal এবং engine adapter-এর মতো ক্ষেত্রে অবদান স্বাগত। পরিবর্তন জমা দেওয়ার আগে repository-এর contributing guide পর্যালোচনা করুন।

উপসংহার

Capri Windows ব্যবহারকারীদের supported AI assistant-কে file, project ও code নিয়ে কাজ করার নির্দেশ দেওয়ার জন্য একটি desktop interface দেয়। application ইনস্টল করুন, পছন্দের engine সংযুক্ত করুন, প্রয়োজনীয় folder-গুলোতেই প্রবেশাধিকার সীমিত রাখুন এবং approval-based বা read-only permission দিয়ে শুরু করুন। কম্পিউটারে কোনো AI agent-কে কাজ করার অনুমতি দেওয়ার সময় স্পষ্ট prompt, সতর্ক পর্যালোচনা, backup এবং সীমিত প্রবেশাধিকার অপরিহার্য।