Auto-Checkin দিয়ে দৈনিক AI কোটা চেক-ইন স্বয়ংক্রিয় করুন

Auto-Checkin কী করে

Auto-Checkin হলো একটি Python অটোমেশন টুলকিট, যা GoRouter, Tabi AI, JustDoWork এবং SeekAI-তে একাধিক অ্যাকাউন্টের দৈনিক চেক-ইন সম্পন্ন করে। প্রতিটি অ্যাকাউন্টে ম্যানুয়ালি চেক-ইন না করেই এসব প্রদানকারীর দেওয়া বিনামূল্যের দৈনিক LLM কোটা সংগ্রহ করাই এর উদ্দেশ্য।

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

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

• চারটি সমর্থিত প্রদানকারী: GoRouter, Tabi AI, JustDoWork এবং SeekAI।
• একাধিক অ্যাকাউন্টের কনফিগারেশন: একটি JSON কনফিগারেশন ফাইলে একাধিক সমর্থিত অ্যাকাউন্ট সংরক্ষণ করুন।
• স্বয়ংক্রিয় সেশন যাচাই: চেক-ইন প্রক্রিয়ার অংশ হিসেবে কনফিগার করা সেশন যাচাই করুন।
• প্ল্যাটফর্মভিত্তিক অথেনটিকেশন: প্রয়োজনীয় টোকেন ও হেডার প্যারামিটার নির্ধারিতভাবে পাঠান।
• Turnstile সমাধান: স্বয়ংক্রিয়ভাবে Cloudflare Turnstile সমাধানের জন্য একটি YesCaptcha ক্লায়েন্ট কী ব্যবহার করুন।
• নির্ধারিত সময়ে চালানো: cron-এর মাধ্যমে প্রতিদিন স্ক্রিপ্ট চালান।
• AI এজেন্টের কনটেক্সট: অন্তর্ভুক্ত এজেন্ট নির্দেশনা এবং মেশিন-পাঠযোগ্য কনটেক্সট ফাইল ব্যবহার করুন।

সমর্থিত প্ল্যাটফর্ম ও ক্রেডেনশিয়াল

প্রতিটি অ্যাকাউন্টের জন্য একটি অ্যাক্সেস টোকেন প্রয়োজন। GoRouter-এর ক্ষেত্রে অ্যাকাউন্ট ড্যাশবোর্ডে প্রদর্শিত সংখ্যাসূচক ইউজার ID-ও প্রয়োজন।

• GoRouter: https://gorouter.app ব্যবহার করে। একটি অ্যাক্সেস টোকেন এবং সংখ্যাসূচক ইউজার ID দিন। এর মিডলওয়্যারে ওই ID-এর সঙ্গে মিলে এমন New-Api-User: <USER_ID> হেডার প্রয়োজন।
• Tabi AI: https://tabitoken.com ব্যবহার করে এবং একটি অ্যাক্সেস টোকেন প্রয়োজন।
• JustDoWork: https://api.justwoker.icu ব্যবহার করে এবং একটি অ্যাক্সেস টোকেন প্রয়োজন।
• SeekAI: https://seekai.cc ব্যবহার করে এবং একটি অ্যাক্সেস টোকেন প্রয়োজন।

README অনুযায়ী, GoRouter এবং Tabi AI-এর দৈনিক পুরস্কার 2.5M–5.0M কোটা, JustDoWork-এর 10.0M–15.0M এবং SeekAI-এর 10.0M। এগুলো প্রদানকারীদের অফার, তাই টুলকিটের ওপর নির্ভর না করেই পরিবর্তিত হতে পারে।

পূর্বশর্ত

• Python 3.9 বা পরবর্তী সংস্করণ।
• রিপোজিটরি ক্লোন করার জন্য Git।
• সমর্থিত কোনো প্ল্যাটফর্মে অন্তত একটি অ্যাকাউন্ট।
• সংশ্লিষ্ট প্ল্যাটফর্মের অ্যাক্সেস টোকেন।
• GoRouter কনফিগার করার সময় একটি সংখ্যাসূচক ড্যাশবোর্ড ইউজার ID।
• Turnstile সমাধানের জন্য একটি YesCaptcha ক্লায়েন্ট কী।

ধাপ 1: টুলকিট ইনস্টল করুন

রিপোজিটরি ক্লোন করুন, এর ডিরেক্টরিতে প্রবেশ করুন, একটি বিচ্ছিন্ন Python পরিবেশ তৈরি ও সক্রিয় করুন এবং ঘোষিত নির্ভরতাগুলো ইনস্টল করুন:

git clone https://github.com/d4ncboz/auto-checkin.git
cd auto-checkin
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

উপরের কমান্ডগুলো Linux ও macOS শেলের জন্য প্রযোজ্য সক্রিয়করণ পদ্ধতি ব্যবহার করে। পরে cron উদাহরণের মাধ্যমে প্রকল্পটি চালানোর পরিকল্পনা থাকলে ভার্চুয়াল পরিবেশটি রেখে দিন।

ধাপ 2: একটি YesCaptcha ক্লায়েন্ট কী সংগ্রহ করুন

প্রকল্পের YesCaptcha রেফারেল লিংক ব্যবহার করে নিবন্ধন করুন এবং আপনার ইমেইল ঠিকানা দিয়ে লগ ইন করুন। README অনুযায়ী, নিবন্ধিত ইমেইল এবং রেফারেল কোড akS4rP দিয়ে Telegram-এ YesCaptcha সহায়তা-র সঙ্গে যোগাযোগ করে ব্যবহারকারীরা 1,500 বিনামূল্যের পয়েন্ট চাইতে পারেন।

README-এর হিসাব অনুযায়ী, 1,500 পয়েন্টে আনুমানিক 750–1,500টি Turnstile সমাধান করা যায়। প্রকৃত ব্যবহার সলভার সার্ভিসের ওপর নির্ভর করে।

পয়েন্ট যোগ হওয়ার পর YesCaptcha ড্যাশবোর্ড থেকে clientKey কপি করুন। এটি স্থানীয় অ্যাকাউন্ট কনফিগারেশনে যোগ করবেন।

ধাপ 3: অ্যাকাউন্ট কনফিগারেশন তৈরি করুন

অন্তর্ভুক্ত উদাহরণ ফাইলটি কপি করুন:

cp accounts.example.json accounts.json

accounts.json খুলে আপনার YesCaptcha কী এবং প্ল্যাটফর্ম ক্রেডেনশিয়াল দিয়ে প্লেসহোল্ডারগুলো প্রতিস্থাপন করুন। প্রতিটি সমর্থিত প্রদানকারীর জন্য একটি করে অ্যাকাউন্টসহ কনফিগারেশন দেখতে এমন হবে:

{
  "yescaptcha_key": "YOUR_YESCAPTCHA_CLIENT_KEY",
  "accounts": [
    {
      "platform": "gorouter",
      "name": "GoRouter_Account_1",
      "token": "YOUR_GOROUTER_ACCESS_TOKEN",
      "user_id": 12345
    },
    {
      "platform": "tabitoken",
      "name": "Tabi_Account_1",
      "token": "YOUR_TABI_ACCESS_TOKEN"
    },
    {
      "platform": "justwoker",
      "name": "JustDoWork_Account_1",
      "token": "YOUR_JUSTDOWORK_ACCESS_TOKEN"
    },
    {
      "platform": "seekai",
      "name": "SeekAI_Account_1",
      "token": "YOUR_SEEKAI_ACCESS_TOKEN"
    }
  ]
}

ফিল্ডগুলো বুঝে নিন

• yescaptcha_key-এ YesCaptcha ড্যাশবোর্ড থেকে কপি করা ক্লায়েন্ট কী থাকে।
• accounts হলো স্ক্রিপ্টের প্রক্রিয়াকরণ করা অ্যাকাউন্টগুলোর তালিকা।
• platform উদাহরণে দেখানো মান ব্যবহার করে প্রদানকারী শনাক্ত করে।
• name কনফিগার করা অ্যাকাউন্টগুলো আলাদা করে চেনার জন্য একটি পাঠযোগ্য লেবেল।
• token-এ প্রদানকারীর অ্যাক্সেস টোকেন থাকে।
• user_id GoRouter-এর জন্য আবশ্যক এবং এর ড্যাশবোর্ড প্রোফাইলের সংখ্যাসূচক ID হতে হবে।

আপনি কেবল ব্যবহৃত প্রদানকারীগুলো কনফিগার করতে পারেন অথবা অতিরিক্ত অ্যাকাউন্টের জন্য আরও এন্ট্রি যোগ করতে পারেন। একই অবজেক্ট কাঠামো বজায় রাখুন এবং প্রতিটি এন্ট্রির জন্য উপযুক্ত প্ল্যাটফর্ম মান ব্যবহার করুন।

ধাপ 4: চেক-ইন চালান

ভার্চুয়াল পরিবেশ সক্রিয় থাকা অবস্থায় এবং accounts.json কনফিগার করা হলে চালান:

python checkin.py

এটি কনফিগার করা সব অ্যাকাউন্টের জন্য একবার চেক-ইন সম্পন্ন করে। কমান্ডটি শিডিউল করার আগে ম্যানুয়ালি চালান, যাতে অবৈধ টোকেন, ভুল GoRouter ইউজার আইডি, ত্রুটিপূর্ণ JSON, অথবা YesCaptcha কনফিগারেশন-সংক্রান্ত সমস্যা শনাক্ত করতে পারেন।

ধাপ ৫: দৈনিক কার্যসম্পাদন শিডিউল করুন

ক্রন-সমর্থিত কোনো সিস্টেমে নিচের কমান্ডটি এমন একটি কাজ ইনস্টল করে, যা সার্ভারের কনফিগার করা টাইম জোন অনুযায়ী প্রতিদিন সকাল ১১:০০টায় চলে। README-তে নির্ধারিত সময় সকাল ১১:০০ WIB হিসেবে উল্লেখ করা হয়েছে, তাই হোস্টের টাইম জোন সেই প্রত্যাশার সঙ্গে মেলে কি না যাচাই করুন।

(crontab -l 2>/dev/null; echo "0 11 * * * cd $(pwd) && .venv/bin/python checkin.py >> checkin.log 2>&1") | crontab -

কাজটি বর্তমান প্রজেক্ট ডিরেক্টরিতে প্রবেশ করে, .venv থেকে Python ইন্টারপ্রেটার চালু করে এবং স্ট্যান্ডার্ড আউটপুট ও ত্রুটিগুলো checkin.log-এ যুক্ত করে।

ক্রন এন্ট্রি যাচাই করুন

ইনস্টলেশনের পর সক্রিয় ক্রনট্যাব পরীক্ষা করুন:

crontab -l

প্রথম নির্ধারিত রান সম্পন্ন হওয়ার পর checkin.log-ও পর্যালোচনা করুন। এতে ক্রন প্রজেক্ট ডিরেক্টরি, ভার্চুয়াল এনভায়রনমেন্ট, কনফিগারেশন ফাইল এবং নেটওয়ার্কে প্রবেশ করতে পারছে কি না নিশ্চিত করা যায়।

উন্নত কনফিগারেশন টিপস

সঠিক প্ল্যাটফর্ম আইডেন্টিফায়ার ব্যবহার করুন

উদাহরণে দেখানো প্ল্যাটফর্মের মানগুলো হুবহু রাখুন: gorouter, tabitoken, justwoker, এবং seekai। কনফিগারেশনের নামগুলো প্রতিটি প্রোভাইডারের সর্বজনীন প্রদর্শন নামের সঙ্গে মেলে না, তাই সঠিকভাবে কপি করলে অ্যাকাউন্ট ভুলভাবে রাউট হওয়া এড়ানো যায়।

GoRouter প্রমাণীকরণ আবার যাচাই করুন

শুধু একটি বৈধ GoRouter টোকেন যথেষ্ট নয়। সংখ্যাসূচক user_id-টি ড্যাশবোর্ড প্রোফাইলের সঙ্গে মিলতে হবে, কারণ প্ল্যাটফর্মটি New-Api-User হেডারে এই মান প্রত্যাশা করে। user_id-কে উদ্ধৃত বর্ণনামূলক ইউজারনেম হিসেবে যোগ করবেন না।

ক্রেডেনশিয়াল ফাইল সুরক্ষিত রাখুন

accounts.json-এ অ্যাক্সেস টোকেন এবং YesCaptcha ক্লায়েন্ট কী রয়েছে। ফাইলটি ব্যক্তিগত রাখুন, কমিট বা লগে প্রকাশ করা এড়িয়ে চলুন এবং অন্য ব্যবহারকারীদের সঙ্গে শেয়ার করা মেশিনে এর অ্যাক্সেস সীমিত করুন।

অটোমেশনের জন্য স্থিতিশীল পাথ ব্যবহার করুন

রিপোজিটরির ভেতরে শেল চালু থাকা অবস্থায় ক্রন এন্ট্রি ইনস্টল করুন, কারণ প্রদত্ত কমান্ডটি $(pwd) প্রসারিত করে। পরে রিপোজিটরি সরানো হলে নতুন অবস্থান নির্দেশ করতে ক্রন এন্ট্রি আপডেট করুন।

নিয়মিত লগ পর্যালোচনা করুন

প্রদত্ত ক্রন কমান্ড প্রতিটি রান checkin.log-এ যুক্ত করে। প্রমাণীকরণ ব্যর্থতা, সলভার সমস্যা বা প্রোভাইডারের পরিবর্তনের জন্য এই ফাইলটি পরীক্ষা করুন এবং নিয়মিত সার্ভার রক্ষণাবেক্ষণের অংশ হিসেবে এর আকার নিয়ন্ত্রণ করুন।

AI এজেন্ট ইন্টিগ্রেশন

রিপোজিটরিতে এমন কনটেক্সট ফাইল রয়েছে, যা সামঞ্জস্যপূর্ণ AI কোডিং ও অটোমেশন এজেন্টদের প্রজেক্টটি বুঝতে সহায়তা করে:

• SKILL.md Hermes Agent এবং OpenClaw-এর স্বয়ংক্রিয় টুল ব্যবহারের জন্য কনটেক্সট প্রদান করে।
• AGENTS.md-এ Claude Code, Cursor, Windsurf এবং Codex-এর জন্য নির্দেশনা রয়েছে।
• llms.txt LLM ক্রলার ইনজেশনের জন্য মেশিন-পাঠযোগ্য স্পেসিফিকেশন প্রদান করে।

কোনো এজেন্টকে টুলকিট পরিবর্তন বা সম্পাদনের অনুরোধ করার আগে এই ফাইলগুলো পর্যালোচনা করুন, যাতে এজেন্ট রিপোজিটরি-নির্দিষ্ট নির্দেশনা অনুসরণ করতে পারে।

উপসংহার

Auto-Checkin একটি হালকা Python ওয়ার্কফ্লোতে চারটি AI অ্যাগ্রিগেশন প্রোভাইডারের দৈনিক চেক-ইন কেন্দ্রীভূত করে। Python নির্ভরতা, accounts.json, প্ল্যাটফর্ম ক্রেডেনশিয়াল এবং YesCaptcha কনফিগার করার পর python checkin.py দিয়ে সব অ্যাকাউন্ট পরীক্ষা করতে এবং অনুপস্থিতিতে দৈনিক চালানোর জন্য ক্রন ব্যবহার করতে পারবেন। তৈরি হওয়া লগ পর্যবেক্ষণ করুন এবং সব ক্রেডেনশিয়াল ফাইল সুরক্ষিত রাখুন।