প্রকল্প সম্পর্কে

# html-video **HTML ভিডিও হয়ে যায় — আপনার ল্যাপটপে।** html-video একটি প্রোগ্রাম্যাটিক ভিডিও টুল যা কোডিং এজেন্টদের (Open Design, Windsurf CLI, Trae CLI, Claude Code, Cursor, Codex, Gemini, Grok, Qwen, OpenCode, Copilot, Aider, Hermes, বা Anthropic API) HTML, CSS এবং ডেটাকে বাস্তব MP4 ফাইলে রূপান্তর করতে দেয়। একটি ভিডিও বর্ণনা করুন, একটি নিবন্ধ লিংক বা GitHub রিপো পেস্ট করুন, এবং এজেন্ট একটি মাল্টি-ফ্রেম অ্যানিমেটেড ভিডিও তৈরি করে, যা প্লাগেবল ইঞ্জিন দিয়ে স্থানীয়ভাবে রেন্ডার হয়। Apache-2.0 লাইসেন্স, প্রতি-রেন্ডার ফি নেই, ভেন্ডর লক-ইন নেই। ## মূল বৈশিষ্ট্য - **১৪টি এজেন্ট ব্যাকএন্ড**: Open Design (Vela), Windsurf CLI, Trae CLI, Claude Code, Cursor Agent, Codex CLI, Gemini CLI, Grok Build, Qwen Code, OpenCode, GitHub Copilot CLI, Aider, Hermes এবং Anthropic Messages API স্বয়ংক্রিয়ভাবে সনাক্ত ও সমর্থন করে। - **২১টি কিউরেটেড টেমপ্লেট**: লাইসেন্স-পরিষ্কার, অ্যানিমেটেড HTML টেমপ্লেট যা ডেটা ভিজ (NYT-স্টাইল চার্ট, সুইস/ভিগনেলি গ্রিড), শিরোনাম ও VFX (গ্লিচ, কাইনেটিক টাইপ, টাইপরাইটার কার্সার), হিরো ও সিনেম্যাটিক (লিকুইড গ্রেডিয়েন্ট, লাইট-লিক, উষ্ণ গ্রেইন), প্রোডাক্ট প্রোমো (১৫সে/৩০সে মাল্টি-সিন) এবং এক্সপ্লেইনার স্ক্যাফোল্ড (ডিসিশন ট্রি) কভার করে। - **বাস্তব MP4 রেন্ডারিং**: হেডলেস ক্রোমিয়াম অ্যানিমেটেড HTML রেকর্ড করে, ffmpeg (libx264) স্থানীয়ভাবে MP4-তে এনকোড করে — কোনো ক্লাউড রেন্ডার নেই, প্রতি-ক্লিপ ফি নেই। - **লিংক-টু-ভিডিও**: ওয়েব নিবন্ধ (WeChat 公众号 সহ) বা GitHub রিপো সার্ভার-সাইডে ফেচ করে, মার্কডাউনে ফ্ল্যাট করে এবং জেনারেশন প্রম্পটে বাস্তব কন্টেন্ট ফিড করে। - **AI সাউন্ডট্র্যাক**: MiniMax-এর মাধ্যমে ঐচ্ছিক ব্যাকগ্রাউন্ড মিউজিক ও বর্ণনা, এক্সপোর্টে MP4-তে মিক্স করা হয় (ভয়েসের নিচে মিউজিক ডাকড, ফেড-ইন/আউট)। - **স্টুডিও + CLI**: একটি স্থানীয় ব্রাউজার স্টুডিও (চ্যাট, টেমপ্লেট গ্যালারি, ফ্রেম, সাউন্ডট্র্যাক, এক্সপোর্ট) এবং একটি স্ক্রিপ্টযোগ্য `html-video` CLI। - **প্লাগেবল ইঞ্জিন আর্কিটেকচার**: একটি `render(input, ctx)` অ্যাডাপ্টার ইন্টারফেস; ইঞ্জিন পরিবর্তন (যেমন, Remotion, Motion Canvas) শুধুমাত্র রেন্ডার ধাপ প্রতিস্থাপন করে, স্টোরিবোর্ড ও এজেন্ট লুপ অপরিবর্তিত রাখে। - **নির্মাণ দ্বারা লাইসেন্স-পরিষ্কার**: টেমপ্লেটগুলিতে মূল লাইসেন্স থাকে, `NOTICE.md` উৎস ও SPDX রেকর্ড করে; কোনো অস্পষ্ট অনুমতিমূলক লাইসেন্স পাঠানো হয় না। ## এটি কীভাবে কাজ করে 1. **উৎস ফেচ**: স্টুডিও URL বা রিপো সার্ভার-সাইডে টানে, মার্কডাউনে ফ্ল্যাট করে। 2. **এজেন্ট লুপ**: এজেন্ট উপাদান + টেমপ্লেট শৈলী পড়ে, একটি কন্টেন্ট-গ্রাফ (স্টোরিবোর্ড) + প্রতি ফ্রেমে একটি HTML ব্লক নির্গত করে। 3. **কন্টেন্ট-গ্রাফ**: মাল্টি-ফ্রেম IR নোড (সত্তা/ডেটা/টেক্সট) এবং এজ (সিকোয়েন্স/ট্রানজিশন) সহ। 4. **প্রতি-ফ্রেম HTML**: প্রতিটি নোড ডিস্কে একটি স্বয়ংসম্পূর্ণ অ্যানিমেটেড HTML ফ্রেম হয়ে যায়। 5. **রেন্ডার**: প্রতিটি ফ্রেম → webm (হেডলেস ক্রোমিয়ামের মাধ্যমে), তারপর ffmpeg MP4-তে এনকোড করে (libx264) এবং সংযুক্ত করে। 6. **সাউন্ডট্র্যাক**: ঐচ্ছিক MiniMax মিউজিক + বর্ণনা ffmpeg-এর মাধ্যমে মিক্স করা হয়। একক-ফ্রেম ভিডিও কন্টেন্ট-গ্রাফ এড়িয়ে একটি দ্রুত পথ নেয়। ## শুরু করা Node.js 20+ এবং ffmpeg প্রয়োজন। না থাকলে Playwright-এর Chromium ইনস্টল করুন। `pnpm -r build` দিয়ে বিল্ড করুন। CLI ইউটিলিটি: - `node packages/cli/dist/bin.js doctor` — ইনস্টল করা এজেন্ট + ইঞ্জিন সনাক্ত করুন - `node packages/cli/dist/bin.js search-templates --intent "github stars race" --top 3` স্টুডিওতে: একটি টেমপ্লেট বেছে নিন (বা একটি ভিডিও বর্ণনা করুন / একটি লিংক পেস্ট করুন), আপনার এজেন্টের সাথে চ্যাট করুন, প্রতি-ফ্রেম টেক্সট সম্পাদনা করুন, একটি সাউন্ডট্র্যাক যোগ করুন এবং MP4 এক্সপোর্ট করুন। ## প্রজেক্ট কাঠামো - `runtime/` — ১৪টি ব্যাকএন্ডের জন্য এজেন্ট রানটাইম (সনাক্ত/স্পন/স্ট্রিম) - `cli/` — `html-video` কমান্ড, স্টুডিও HTTP সার্ভার, উৎস ফেচিং - `project-studio/` — ব্রাউজার স্টুডিও UI (চ্যাট, টেমপ্লেট গ্যালারি, ফ্রেম, সাউন্ডট্র্যাক, এক্সপোর্ট) - `templates/` — ২১টি কিউরেটেড, লাইসেন্স-পরিষ্কার ভিডিও টেমপ্লেট ## সম্পর্কিত প্রজেক্ট - [Open Design](https://github.com/nexu-io/open-design) — সহোদর প্রজেক্ট, ডিজাইন-এজেন্ট মেটা-লেয়ার - [HTML Anything](https://github.com/nexu-io/html-anything) — স্ট্যাটিক HTML ডেলিভারেবলের জন্য সহোদর প্রজেক্ট ## লাইসেন্স Apache-2.0 — প্রতি-রেন্ডার ফি নেই, সিট ক্যাপ নেই, কন্ট্রিবিউটর চুক্তি নেই। Open Design টিমের (nexu-io) একটি অফিসিয়াল প্রজেক্ট।