इस प्रोजेक्ट के बारे में

# 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 लाइसेंस, कोई प्रति-रेंडर शुल्क नहीं, कोई विक्रेता लॉक-इन नहीं। ## मुख्य विशेषताएं - **14 एजेंट बैकएंड**: 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 का स्वतः पता लगाता है और समर्थन करता है। - **21 क्यूरेटेड टेम्पलेट**: लाइसेंस-स्वच्छ, एनिमेटेड HTML टेम्पलेट जिसमें डेटा विज़ुअलाइज़ेशन (NYT-शैली चार्ट, स्विस/विग्नेली ग्रिड), शीर्षक और VFX (ग्लिच, काइनेटिक टाइप, टाइपराइटर कर्सर), हीरो और सिनेमैटिक्स (लिक्विड ग्रेडिएंट, लाइट-लीक, वार्म ग्रेन), उत्पाद प्रोमो (15s/30s मल्टी-सीन), और एक्सप्लेनर स्कैफोल्ड (निर्णय वृक्ष) शामिल हैं। - **वास्तविक MP4 रेंडरिंग**: हेडलेस क्रोमियम एनिमेटेड HTML रिकॉर्ड करता है, ffmpeg (libx264) लोकल रूप से MP4 में एन्कोड करता है — कोई क्लाउड रेंडर नहीं, कोई प्रति-क्लिप शुल्क नहीं। - **लिंक-टू-वीडियो**: वेब लेख (WeChat 公众号 सहित) या GitHub रेपो सर्वर-साइड लाता है, Markdown में फ्लैट करता है, और वास्तविक सामग्री को जनरेशन प्रॉम्प्ट में फीड करता है। - **AI साउंडट्रैक**: MiniMax के माध्यम से वैकल्पिक पृष्ठभूमि संगीत और कथन, निर्यात पर MP4 में मिश्रित (संगीत आवाज़ के नीचे, फीका-इन/आउट)। - **स्टूडियो + CLI**: एक लोकल ब्राउज़र स्टूडियो (चैट, टेम्पलेट गैलरी, फ्रेम, साउंडट्रैक, निर्यात) और एक स्क्रिप्टेबल `html-video` CLI। - **प्लगेबल इंजन आर्किटेक्चर**: एक `render(input, ctx)` एडेप्टर इंटरफ़ेस; इंजन स्वैपिंग (जैसे, Remotion, Motion Canvas) केवल रेंडर चरण को बदलता है, स्टोरीबोर्ड और एजेंट लूप को अछूता छोड़ता है। - **निर्माण द्वारा लाइसेंस-स्वच्छ**: टेम्पलेट मूल लाइसेंस रखते हैं, `NOTICE.md` स्रोतों और SPDX रिकॉर्ड करता है; कोई अस्पष्ट अनुमेय लाइसेंस शिप नहीं होता। ## यह कैसे काम करता है 1. **स्रोत प्राप्ति**: स्टूडियो URL या रेपो सर्वर-साइड खींचता है, Markdown में फ्लैट करता है। 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/` — सभी 14 बैकएंड के लिए एजेंट रनटाइम (पता लगाना/स्पॉन/स्ट्रीम) - `cli/` — `html-video` कमांड, स्टूडियो HTTP सर्वर, स्रोत प्राप्ति - `project-studio/` — ब्राउज़र स्टूडियो UI (चैट, टेम्पलेट गैलरी, फ्रेम, साउंडट्रैक, निर्यात) - `templates/` — 21 क्यूरेटेड, लाइसेंस-स्वच्छ वीडियो टेम्पलेट ## संबंधित परियोजनाएं - [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) द्वारा एक आधिकारिक परियोजना।