প্রকল্প পরিচিতি
Turb GPT Register হলো স্থানীয় কম্পিউটারে চলা একটি রেজিস্ট্রেশন প্রক্রিয়া টুল, যা gpt-free-register-এর ওপর ভিত্তি করে সাজানো ও সম্প্রসারিত হয়েছে। এটি ইমেইল, প্রক্সি এবং রেজিস্ট্রেশন প্রক্রিয়াকে কেন্দ্রীয়ভাবে পরিচালনা করে। এটি প্রোটোকল-চালিত পদ্ধতি সমর্থন করে এবং স্থানীয় ফিঙ্গারপ্রিন্ট ব্রাউজারের সঙ্গেও সংযুক্ত হতে পারে।
প্রকল্পটি কমান্ড লাইন থেকে চালু করা যায় এবং পরিবেশ কনফিগারেশন ও কাজ পরিচালনার জন্য একটি স্থানীয় WebUI প্রদান করে। মনে রাখবেন, এটি কোনো অ্যাকাউন্ট, ইমেইল বা প্রক্সি সরবরাহ করে না এবং তৃতীয় পক্ষের পরিষেবা সবসময় সচল থাকবে, এমন নিশ্চয়তাও দেয় না।
শুধু এমন পরিবেশে এটি চালান যা ব্যবহারের অধিকার আপনার আছে এবং সংশ্লিষ্ট পরিষেবা, ইমেইল প্রদানকারী ও প্রক্সি প্রদানকারীর নিয়ম মেনে চলুন।
প্রধান বৈশিষ্ট্য ও প্রকল্প কাঠামো
প্রধান বৈশিষ্ট্য
- স্থানীয় কম্পিউটারে চলে; কনফিগারেশন ও ফলাফল স্থানীয়ভাবে সংরক্ষিত হয়।
- ইমেইল পরিষেবা, প্রক্সি ও রেজিস্ট্রেশন প্রক্রিয়া কেন্দ্রীয়ভাবে পরিচালনা করে।
- প্রোটোকল-চালিত রেজিস্ট্রেশন কম্পোনেন্ট সমর্থন করে।
- স্থানীয় ফিঙ্গারপ্রিন্ট ব্রাউজারের সঙ্গে সংযুক্ত হতে পারে।
- কমান্ড লাইন এন্ট্রি এবং স্থানীয় WebUI প্রদান করে।
- মূল লজিক, কনফিগারেশন, পৃষ্ঠা, টুল ও তৃতীয় পক্ষের কম্পোনেন্ট আলাদা ডিরেক্টরিতে পরিচালনা করে।
ডিরেক্টরি পরিচিতি
core/: মূল প্রোগ্রাম ও কোর লজিক।config/: প্রকল্পের কনফিগারেশন।webui/: স্থানীয় ব্যবস্থাপনা পৃষ্ঠা।tools/: সহায়ক স্ক্রিপ্ট।vendor/gpt-register-tool/协议: প্রোটোকল রেজিস্ট্রেশন কম্পোনেন্ট ও সংশ্লিষ্ট ফাইল।
কোড বা কনফিগারেশন সমস্যা নির্ণয়ের সময় প্রথমে ফিচার অনুযায়ী সংশ্লিষ্ট ডিরেক্টরি খুঁজে দেখুন। সাধারণত পুরো রিপোজিটরিতে অনুসন্ধানের চেয়ে এটি বেশি কার্যকর।
ইনস্টলেশনের আগে প্রস্তুতি
প্রকল্পটির জন্য Python 3.11 ব্যবহারের পরামর্শ দেওয়া হয়। নিচের ইনস্টলেশন কমান্ডগুলো Windows PowerShell-এর জন্য প্রযোজ্য এবং ধরে নেওয়া হয়েছে যে আপনি রিপোজিটরিটি স্থানীয় কম্পিউটারে ডাউনলোড করেছেন।
এছাড়াও আপনাকে নিজে ব্যবহারযোগ্য ইমেইল পরিষেবা ও প্রক্সি কনফিগারেশন প্রস্তুত করতে হবে। ব্রাউজার ড্রাইভার ব্যবহার করলে অতিরিক্ত ব্রাউজার বা সরবরাহকারীর ক্লায়েন্ট ইনস্টল করার প্রয়োজন হতে পারে। pip install চালালে শুধু Python নির্ভরতা ইনস্টল হবে; এসব বাহ্যিক প্রোগ্রাম স্বয়ংক্রিয়ভাবে ইনস্টল হবে না।
ইনস্টলেশন ও চালু করা
ধাপ ১: ভার্চুয়াল পরিবেশ তৈরি
রিপোজিটরির মূল ডিরেক্টরিতে PowerShell খুলে .venv নামের একটি Python ভার্চুয়াল পরিবেশ তৈরি করুন:
python -m venv .venvধাপ ২: ভার্চুয়াল পরিবেশ সক্রিয় করা
.venv\Scripts\Activate.ps1সক্রিয় করার পর ইনস্টল করা Python প্যাকেজগুলো এই প্রকল্পের ভার্চুয়াল পরিবেশে রাখা হবে, ফলে সিস্টেমের অন্যান্য Python প্রকল্পে প্রভাব পড়বে না।
ধাপ ৩: নির্ভরতা ইনস্টল করা
pip install -r requirements.txtইনস্টলেশন ব্যর্থ হলে সম্পূর্ণ ত্রুটির তথ্য সংরক্ষণ করুন এবং Python সংস্করণ, নেটওয়ার্ক পরিবেশ ও নির্ভরতা ইনস্টলেশন লগ পরীক্ষা করুন।
ধাপ ৪: স্থানীয় কনফিগারেশন ফাইল তৈরি
Copy-Item .env.example .env.env.example একটি কনফিগারেশন নমুনা। কপি করার পর নিজের .env সম্পাদনা করে প্রকৃত রানটাইম পরিবেশের প্রয়োজনীয় কনফিগারেশন পূরণ করুন।
প্রকৃত ইমেইল পরিচয়পত্র, প্রক্সি কী বা অন্য কোনো সংবেদনশীল তথ্য
.env.example-এ লিখবেন না। প্রকৃত পরিচয়পত্রসহ.envফাইল Git-এ জমা দেবেন না।
ধাপ ৫: WebUI চালু করা
python web.pyপ্রোগ্রাম চালু হলে স্থানীয় WebUI খুলুন। পৃষ্ঠায় দেওয়া কনফিগারেশন ফিল্ড অনুযায়ী নিজের ইমেইল পরিষেবা ও প্রক্সি তথ্য পূরণ করুন, তারপর সংশ্লিষ্ট কাজ পরিচালনা করুন। README কোনো নির্দিষ্ট পৃষ্ঠা ঠিকানা বা ফিল্ডের নামের প্রতিশ্রুতি দেয়নি, তাই প্রোগ্রামের স্টার্টআপ লগ ও বর্তমান WebUI পৃষ্ঠাকে চূড়ান্ত নির্দেশনা হিসেবে ধরুন।
মৌলিক ব্যবহার প্রক্রিয়া
- Python 3.11, ভার্চুয়াল পরিবেশ ও প্রকল্পের নির্ভরতা প্রস্তুত আছে কি না নিশ্চিত করুন।
.env.exampleথেকে.envতৈরি করে নিজের রানটাইম কনফিগারেশন পূরণ করুন।python web.pyব্যবহার করে স্থানীয় ব্যবস্থাপনা পৃষ্ঠা চালু করুন।- WebUI-তে ব্যবহারের অধিকার থাকা ইমেইল পরিষেবা ও প্রক্সি কনফিগার করুন।
- স্থানীয় পরিবেশ অনুযায়ী প্রোটোকল-চালিত বা ব্রাউজার-চালিত পদ্ধতি বেছে নিন।
- কাজ চালানোর পর ফলাফল ও লগ পরীক্ষা করে ইমেইল, প্রক্সি এবং ড্রাইভার ধাপগুলো স্বাভাবিক আছে কি না নিশ্চিত করুন।
PowerShell-এ সম্পূর্ণ চালু করার একটি উদাহরণ:
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env
python web.pyপ্রোটোকল রেজিস্ট্রেশন কম্পোনেন্ট আলাদাভাবে ব্যবহার
প্রোটোকল রেজিস্ট্রেশন কম্পোনেন্টটি vendor/gpt-register-tool/协议-এ রয়েছে। মূল WebUI ছাড়া এটি আলাদাভাবে চালাতে চাইলে ওই ডিরেক্টরিতে প্রবেশ করুন, কম্পোনেন্টটির নিজস্ব নির্দেশনা পড়ুন এবং সেখানে উল্লেখিত নির্ভরতা ইনস্টল করুন।
এই ডিরেক্টরির কম্পোনেন্টগুলোর আলাদা আপস্ট্রিম উৎস, লাইসেন্স ও কপিরাইট নির্দেশনা থাকতে পারে। ব্যবহারের আগে এর নিজস্ব ডকুমেন্টেশন ও লাইসেন্স ফাইলও দেখুন। মূল প্রকল্পের ইনস্টলেশন পদ্ধতি ও লাইসেন্স সবকিছুর ক্ষেত্রে প্রযোজ্য, এমন ধরে নেবেন না।
উন্নত ব্যবহার ও রক্ষণাবেক্ষণের পরামর্শ
সমস্যা নির্ণয়ে আগে লগ ও কনফিগারেশন দেখুন
রেজিস্ট্রেশন প্রক্রিয়া ইমেইল প্রদানকারী, প্রক্সি পরিষেবা ও ব্রাউজার পরিবেশের ওপর নির্ভরশীল। যেকোনো পক্ষ ইন্টারফেস পরিবর্তন করলে, নেটওয়ার্কে ওঠানামা হলে বা ক্লায়েন্টের আচরণ বদলালে প্রক্রিয়া ব্যর্থ হতে পারে। সমস্যা হলে নিচের ক্রমে পরীক্ষা করুন:
- সম্পূর্ণ লগ দেখুন এবং প্রথম দেখা দেওয়া ত্রুটিটি শনাক্ত করুন।
.envও WebUI-এর কনফিগারেশন মিলিয়ে দেখুন।- ইমেইল পরিষেবায় এখনও প্রবেশ করা যাচ্ছে কি না যাচাই করুন।
- প্রক্সি পরিচয়পত্র, নেটওয়ার্ক সংযোগ ও স্থিতিশীলতা পরীক্ষা করুন।
- ব্রাউজার ড্রাইভার ব্যবহার করলে ব্রাউজার বা সরবরাহকারীর ক্লায়েন্ট সঠিকভাবে ইনস্টল ও চালু আছে কি না নিশ্চিত করুন।
- প্রোটোকল কম্পোনেন্ট ব্যবহার করলে তার ডিরেক্টরির নির্ভরতা ও আপস্ট্রিম নির্দেশনা পরীক্ষা করুন।
স্থানীয় রানটাইম ডেটা সুরক্ষিত রাখা
ইমেইল পুল, প্রক্সি পরিচয়পত্র, অ্যাকাউন্ট ডেটাবেস, ব্রাউজার প্রোফাইল, লগ ও এক্সপোর্ট ফাইল স্থানীয় রানটাইম ডেটার অন্তর্ভুক্ত। এসব ফাইলে সংবেদনশীল তথ্য থাকতে পারে, তাই এগুলো প্রকাশ্য বা শেয়ার করা রিপোজিটরিতে জমা দেওয়া উচিত নয়।
প্রকল্পের .gitignore সাধারণ ডেটা ফাইল বাদ দিলেও কোড জমা দেওয়ার আগে জমা দেওয়ার তালিকা নিজে পরীক্ষা করুন। পরিচয়পত্র সুরক্ষায় শুধু ফাইলের নাম বা ignore নিয়মের ওপর নির্ভর করবেন না।
কার্যকর সমস্যা প্রতিবেদন তৈরি
প্রকল্পে Issue বা Pull Request জমা দিতে হলে যথেষ্ট ডায়াগনস্টিক তথ্য দিন:
- সম্পূর্ণ বা গুরুত্বপূর্ণ ত্রুটির তথ্য।
- অপারেটিং সিস্টেম, Python সংস্করণ ও সংশ্লিষ্ট রানটাইম পরিবেশ।
- পুনরায় সম্পাদনযোগ্য ধাপ।
- প্রোটোকল ড্রাইভার নাকি ব্রাউজার ড্রাইভার ব্যবহার করা হয়েছে।
- পাসওয়ার্ড, টোকেন ও প্রক্সি পরিচয়পত্র গোপন রেখে প্রয়োজনীয় কনফিগারেশন বিবরণ।
প্রকৃত পরিচয়পত্র প্রকাশ্যে পেস্ট করবেন না। পরিষ্কার পরিবেশের তথ্য ও পুনরুৎপাদনযোগ্য ধাপ সাধারণত শুধু “কাজ করছে না” বলার চেয়ে সমস্যা শনাক্ত করতে বেশি সহায়তা করে।
তৃতীয় পক্ষের নির্ভরতার পরিবর্তন নজরে রাখা
ইমেইল ইন্টারফেস, প্রক্সি নেটওয়ার্ক ও ব্রাউজার সরবরাহকারীর ক্লায়েন্ট স্বাধীনভাবে পরিবর্তিত হতে পারে। প্রকল্পটি এসব ধাপকে কনফিগারেশন ও ড্রাইভারে ভাগ করেছে, যাতে নিজের পরিবেশ অনুযায়ী সমন্বয় করা যায়। তবে এই নকশা তৃতীয় পক্ষের পরিবর্তনজনিত ত্রুটি দূর করতে পারে না। আপগ্রেড বা পরিবর্তনের আগে বর্তমান কার্যকর কনফিগারেশন সংরক্ষণ করুন এবং ধাপে ধাপে যাচাই করুন।
লাইসেন্স ও ব্যবহারের সীমা
মূল প্রকল্পটি xiaoguzuiniu/gpt-free-register-এর ওপর ভিত্তি করে পরিবর্তিত হয়েছে এবং MIT License-এর অধীনে প্রকাশিত। বিস্তারিত তথ্য রিপোজিটরির LICENSE ফাইলে দেখুন।
vendor/gpt-register-tool/协议-এর কম্পোনেন্টগুলো নিজ নিজ আপস্ট্রিমের লাইসেন্স ও কপিরাইট নির্দেশনা বজায় রাখে। এসব কম্পোনেন্ট বিতরণ, পরিবর্তন বা স্থাপনের আগে প্রত্যেকটির লাইসেন্সের শর্ত আলাদাভাবে যাচাই করুন।
সারসংক্ষেপ
Turb GPT Register ইমেইল, প্রক্সি, প্রোটোকল কম্পোনেন্ট ও ব্রাউজার ড্রাইভারকে স্থানীয় ওয়ার্কফ্লোতে একত্র করে এবং WebUI-এর মাধ্যমে একটি কেন্দ্রীয় ব্যবস্থাপনা প্রবেশদ্বার দেয়। ব্যবহারের আগে Python 3.11 পরিবেশ, নির্ভরতা ও .env কনফিগারেশন সম্পন্ন করুন। এরপর নিজের বৈধ অনুমতিপ্রাপ্ত পরিবেশ অনুযায়ী ড্রাইভার পদ্ধতি বেছে নিন। সমস্যা হলে আগে লগ, কনফিগারেশন ও তৃতীয় পক্ষের পরিষেবার অবস্থা পরীক্ষা করুন এবং সব স্থানীয় পরিচয়পত্র ও রানটাইম ডেটা যথাযথভাবে সুরক্ষিত রাখুন।