shipwords দিয়ে কীওয়ার্ড-কেন্দ্রিক AI সাইট ফ্লিট তৈরি ও চালু করুন

shipwords যা করে

shipwords হলো MIT লাইসেন্সযুক্ত একটি ওপেন-সোর্স ফ্রেমওয়ার্ক, যা Cloudflare-এ AI ছবি ও ভিডিও সাইটের একটি বহর চালানোর জন্য তৈরি। প্রতিটি কীওয়ার্ডের জন্য একটি আলাদা সাইট থাকে। অ্যাকাউন্ট, পেমেন্ট, ক্রেডিট এবং AI জেনারেশনের মতো যৌথ সুবিধাগুলো ফ্রেমওয়ার্কে একবারই বাস্তবায়ন করা হয়, আর প্রতিটি সাইটের নিজস্ব পেজ, ভিজ্যুয়াল পরিচয়, ডোমেইন, ডেটাবেস, স্টোরেজ এবং পেমেন্ট অ্যাকাউন্ট থাকতে পারে।

প্রতিটি সাইট TanStack Start এবং React 19 অ্যাপ্লিকেশন হিসেবে নিজস্ব Cloudflare Worker-এ চলে, সঙ্গে থাকে D1, R2 এবং Workflows। এই পৃথকীকরণের ফলে আপনি সাইটগুলো স্বাধীনভাবে চালু, আপডেট বা বন্ধ করতে পারেন, আবার ভবিষ্যতের ডিপ্লয়মেন্টে যৌথ কোরের উন্নতিও পেতে পারেন।

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

• অ্যাকাউন্ট পেজসহ Google ও ইমেইল সাইন-ইন।
• ক্রেডিট প্যাক, সাবস্ক্রিপশন, অর্ডার, রিফান্ড এবং বিরোধসহ Stripe ও PayPal সমর্থন।
• ইমেইল নোটিফিকেশন এবং reCAPTCHA v3-এর অপব্যবহার-সীমাসহ অতিথিদের জন্য বিনামূল্যের ট্রায়াল।
• গোপনীয়তা, শর্তাবলি, রিফান্ড এবং DMCA পেজ।
• sitemap.xml, robots.txt এবং llms.txt-সহ SEO ও GEO সহায়ক।
• ওয়ার্কফ্লো-ভিত্তিক জেনারেশন রানটাইম, যেখানে জবের অবস্থা একমুখী এবং ব্যর্থ জবের জন্য স্বয়ংক্রিয় রিফান্ড রয়েছে।
• GPT Image, Nano Banana, Seedream, FLUX, Seedance, Veo, Kling এবং Wan-এর মতো মডেলের জন্য Yir API ইন্টিগ্রেশন।
• মডেল API কী ছাড়াই স্থানীয় ডেভেলপমেন্টের জন্য একটি মক আপস্ট্রিম।
• ffmpeg কনটেইনারের মাধ্যমে ঐচ্ছিক ভিডিও কম্পোজিশন।

পূর্বশর্ত

শুরু করার আগে রিপোজিটরির .nvmrc-এ নির্দিষ্ট Node 24 ইনস্টল করুন এবং প্রত্যাশিত pnpm সংস্করণটি পাওয়ার জন্য Corepack সক্রিয় করুন:

corepack enable

Windows-এ Git Bash বা WSL ব্যবহার করুন। ডিপ্লয় এবং পেমেন্ট গ্রহণের সময় Cloudflare অ্যাকাউন্ট এবং Stripe বা PayPal অ্যাকাউন্ট প্রয়োজন হবে। সাধারণ স্থানীয় সেটআপের জন্য এগুলো প্রয়োজন নেই।

রিপোজিটরি ইনস্টল করুন

রিপোজিটরিটি ফর্ক বা ক্লোন করে এর নির্ভরতাগুলো ইনস্টল করুন:

pnpm install

নতুন সাইটের কাঠামো তৈরি করুন

সম্পূর্ণ AI সাইট টেমপ্লেট থেকে একটি সাইট তৈরি করতে সাইট জেনারেটর ব্যবহার করুন। প্রথম আর্গুমেন্টটি sites/-এর অধীনে ডিরেক্টরির নাম হবে এবং ডোমেইনটি সাইটের কনফিগারেশনে সংরক্ষিত হবে:

pnpm new-site my-tool --domain my-tool.com
pnpm install

তৈরি হওয়া সাইটে হোম পেজ, মূল্য নির্ধারণ, অ্যাকাউন্ট ও লগইন ফ্লো, নীতিমালা পেজ এবং стандарт sitemap.xml, robots.txt ও llms.txt ফাইল থাকে। নতুন সাইটের নির্ভরতাগুলো ইনস্টল করতে আবার pnpm install চালান।

স্থানীয় সিক্রেট কনফিগার করুন

স্থানীয় সিক্রেটগুলো রিপোজিটরির বাইরে রাখুন। একটি কনফিগারেশন ডিরেক্টরি তৈরি করুন, তৈরি হওয়া সাইটের উদাহরণ ভেরিয়েবল ফাইলটি কপি করুন এবং ওয়ার্কট্রি কনফিগারেশন সংযুক্ত করুন:

mkdir -p ~/.config/shipwords
cp sites/my-tool/.dev.vars.example ~/.config/shipwords/my-tool.dev.vars
pnpm setup:worktree

উদাহরণ কনফিগারেশনটি স্থানীয় ডেভেলপমেন্টে সঙ্গে সঙ্গে কাজ করার জন্য তৈরি। ইমেইল সাইন-ইন কোড ডেভেলপমেন্ট সার্ভারের টার্মিনালে প্রিন্ট হয়, নতুন অ্যাকাউন্টগুলো সাইন-আপ ক্রেডিট পায় এবং UPSTREAM_MOCK=1 থাকলে জেনারেশনে মক আপস্ট্রিম ব্যবহার হয়। তাই মডেল API কী ছাড়াই আপনি অ্যাপ্লিকেশন পরীক্ষা করতে পারবেন।

বাস্তব জেনারেশন যোগ করুন

বাস্তব মডেল অনুরোধের জন্য একটি Yir API কী যোগ করুন এবং UPSTREAM_MOCK পরিবর্তন করে মক আপস্ট্রিম বন্ধ করুন।

পেমেন্ট পরীক্ষা করুন

ক্রেডিট কেনাকাটা পরীক্ষা করতে sk_test_ দিয়ে শুরু হওয়া একটি Stripe টেস্ট কী যোগ করুন। সাইট ডিরেক্টরি থেকে রিপোজিটরির ওয়েবহুক ফরওয়ার্ডিং ইউটিলিটি চালান, যাতে স্থানীয় ডেভেলপমেন্ট Stripe ইভেন্ট গ্রহণ করতে পারে:

node ../../tools/stripe-listen.mjs

যৌথ পেমেন্ট কোডটি পুনরাবৃত্ত বা ধারাবাহিকতার বাইরে আসা পেমেন্ট ইভেন্ট, দ্বিগুণ চার্জ এবং ব্যর্থ জবের রিফান্ড পরিচালনার জন্য তৈরি।

ঐচ্ছিক সাইন-ইন ও অতিথি অ্যাক্সেস কনফিগার করুন

অতিথিদের বিনামূল্যের ট্রায়ালের জন্য reCAPTCHA কী প্রয়োজন। এগুলো না থাকলে প্রথম জেনারেশনের আগে ভিজিটরদের সাইন ইন করতে হবে। Google সাইন-ইন ঐচ্ছিক; এটি সক্রিয় করলে একটি Google OAuth ক্লায়েন্ট তৈরি করুন এবং অনুমোদিত অরিজিন হিসেবে http://localhost:<port> ব্যবহার করুন। Google OAuth ছাড়াও ইমেইল সাইন-ইন কাজ করে।

স্থানীয়ভাবে সাইট চালান

তৈরি হওয়া সাইটে যান, স্থানীয় ডেটাবেস আর্টিফ্যাক্ট তৈরি করুন, স্থানীয় মাইগ্রেশন প্রয়োগ করুন এবং ডেভেলপমেন্ট সার্ভার চালু করুন:

cd sites/my-tool
pnpm db:generate && pnpm db:migrate:local
pnpm dev

ডেভেলপমেন্ট সার্ভার যে স্থানীয় URL প্রিন্ট করে, সেটি খুলুন। উদাহরণ কনফিগারেশন ব্যবহার করে ইমেইল অথেন্টিকেশন, অ্যাকাউন্ট তৈরি, ক্রেডিট এবং মক জেনারেশন পরীক্ষা করতে পারবেন।

রিপোজিটরি কমান্ড ব্যবহার করুন

বেশিরভাগ কমান্ড নির্দিষ্ট কোনো সাইটে সীমাবদ্ধ করে বা পুরো রিপোজিটরির পরীক্ষার জন্য ব্যবহার করা যায়:

pnpm new-site <dir> --domain <domain>
pnpm list-sites
pnpm setup:worktree
pnpm --filter "./sites/<site>" dev
pnpm --filter "./sites/<site>" check
pnpm check:packages
pnpm check:template
pnpm lint && pnpm test:tools

list-sites কমান্ড প্রতিটি সাইটের কোড ও README থেকে সাইটের তালিকা তৈরি করে। কোনো সাইটের check কমান্ড টাইপ চেকিং, বিল্ড এবং চালু হওয়ার পরীক্ষা করে। প্যাকেজ চেকগুলো যৌথ কোর ও jobs প্যাকেজ পরীক্ষা করে, আর টেমপ্লেট ও টুলস চেক লঞ্চের আগে সমস্যা শনাক্ত করতে সহায়তা করে।

AI কোডিং এজেন্ট দিয়ে সাইট তৈরি করুন

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

Read shipwords.dev/llms.txt and build a site for "<your keyword>"

এজেন্ট রিপোজিটরি ক্লোন করতে, সাইট তৈরি করতে এবং তা স্থানীয়ভাবে চালাতে পারে। AI কোডিং এজেন্টদের নিয়ম AGENTS.md-এ নথিবদ্ধ করা আছে। উদীয়মান কীওয়ার্ডের ধারণা প্রয়োজন হলে, আলাদা new-term-radar প্রকল্পটি X, Hugging Face, GitHub এবং সাইটম্যাপে নতুন AI শব্দ পর্যবেক্ষণ করে।

উন্নত সাইট আচরণ কাস্টমাইজ করুন

শেয়ার করা জেনারেশন রানটাইম ব্যবহার করুন

packages/jobs প্যাকেজটি একটি ওয়ার্কফ্লো-ভিত্তিক রানটাইম, একটি আপস্ট্রিম অ্যাডাপ্টার ইন্টারফেস, Yir অ্যাডাপ্টার, একটি স্থানীয় মক আপস্ট্রিম এবং ঐচ্ছিক ffmpeg কম্পোজিশন সরবরাহ করে। সাইট-নির্দিষ্ট জেনারেশন আচরণ সাইটের কনফিগারেশনে রাখুন এবং কাজ প্রক্রিয়াকরণ ও রিফান্ড ব্যবস্থাপনার জন্য শেয়ার করা রানটাইম ব্যবহার করুন।

জেনারেশন খরচের সীমা নির্ধারণ করুন

Yir-এর মাধ্যমে মডেল কল প্রতি অনুরোধে বিল করা হয়। প্রতিটি কাজের সর্বোচ্চ খরচ site.models.ts-এ নির্ধারিত থাকে। বাস্তব জেনারেশন সক্রিয় করার আগে এই সীমাগুলো পর্যালোচনা করুন, যাতে সাইটের মূল্য নির্ধারণ এবং ক্রেডিট আচরণ সর্বোচ্চ আপস্ট্রিম খরচের সঙ্গে সামঞ্জস্যপূর্ণ থাকে।

ভিডিও উদাহরণটি পর্যালোচনা করুন

ভিডিও-কেন্দ্রিক সাইটের জন্য sites/tinydeskai-example দেখুন। এটি Tiny Desk AI-এর সম্পূর্ণ সোর্স এবং এতে ফটো স্লট, এক ধাপে ভিডিও সম্পাদনা, আউটপুট যাচাই, ffmpeg কম্পোজিশন এবং কনটেন্ট পেজ প্রদর্শন করা হয়েছে। এর ওয়ার্কফ্লো একটি ভাইরাল ক্লিপকে এমন একটি টেমপ্লেটে রূপান্তর করে, যা দর্শকেরা আপলোড করা ছবি দিয়ে ব্যবহার করতে পারেন।

সাইটগুলোকে স্বাধীন রাখুন

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

প্রোডাকশনের জন্য প্রস্তুত হন

স্থানীয় সাইটটি কাজ করলে, প্রোডাকশন প্রক্রিয়ার জন্য সাইট লঞ্চ হ্যান্ডবুক অনুসরণ করুন। ডোমেইন খরচ, Cloudflare ব্যবহার, পেমেন্ট প্রসেসিং ফি এবং Yir মডেল অনুরোধের জন্য পরিকল্পনা করুন। যেসব ভিডিও সাইট ক্লিপ একত্র করে, সেগুলো Cloudflare Containers ব্যবহার করে এবং Workers Paid প্ল্যান প্রয়োজন।

লঞ্চের আগে সাইটের প্রমাণীকরণ, পেমেন্ট ওয়েবহুক, ক্রেডিট আচরণ, জেনারেশন ব্যর্থতা, রিফান্ড, নীতিমালা পেজ, SEO ফাইল এবং অ্যানালিটিক্স কনফিগারেশন যাচাই করুন। আরও গভীর কনফিগারেশন বিবরণের জন্য রিপোজিটরিতে আর্কিটেকচার এবং স্থানীয় ডেভেলপমেন্ট সংক্রান্ত ডকুমেন্টেশনও রয়েছে।

উপসংহার

প্রতিটি প্রকল্পের জন্য প্রমাণীকরণ, বিলিং, ক্রেডিট, জেনারেশন ওয়ার্কফ্লো এবং SEO সহায়তা নতুন করে তৈরি না করেই একাধিক কীওয়ার্ড-কেন্দ্রিক AI সাইট চালু করার জন্য shipwords একটি ব্যবহারিক ভিত্তি সরবরাহ করে। টেমপ্লেট দিয়ে শুরু করুন, স্থানীয় পরীক্ষার জন্য মক আপস্ট্রিম ব্যবহার করুন, প্রস্তুত হলে বাস্তব প্রোভাইডার যোগ করুন এবং প্রতিটি সম্পূর্ণ সাইট Cloudflare-এ স্বাধীনভাবে ডিপ্লয় করুন।