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

Design Oracle एक MIT-लाइसेंस प्राप्त टूल है जो किसी वेबसाइट का विश्लेषण करने और उसके संपूर्ण डिजाइन सिस्टम को निकालने के लिए उपयोग किया जाता है। यह Next.js फ्रंटएंड, FastAPI बैकएंड, ARQ वर्कर, Redis, SQLite और Playwright/Chromium विश्लेषण पाइपलाइन का संयोजन है। इसकी मुख्य क्षमताओं में Playwright के साथ फुल-पेज कैप्चर, विजुअल स्कोर और ह्यूरिस्टिक्स के साथ डिजाइन DNA वर्गीकरण, हीरो, प्राइसिंग, नेव और FAQ जैसे तत्वों के लिए बाउंडिंग बॉक्स के साथ कंपोनेंट डिटेक्शन, SSE और Redis pub/sub के माध्यम से लाइव प्रोग्रेस, और Tailwind v4 config, React JSX कंपोनेंट्स, JSON डिजाइन टोकन और Markdown DESIGN.md रिपोर्ट के रूप में एक्सपोर्ट शामिल हैं। यह AI वर्कफ़्लो के लिए MCP के माध्यम से विश्लेषण टूल भी प्रदान करता है। सेटअप के लिए, Docker Compose की सिफारिश की जाती है: रिपॉजिटरी .env.example को .env में कॉपी करने और docker compose up --build -d चलाने, फिर http://localhost:3000 खोलने का निर्देश देती है। एक स्थानीय start.sh विकल्प के लिए Python 3.12+, Node.js 20+, और Redis 7+ की आवश्यकता होती है, और यह वर्चुअल एनवायरनमेंट, Playwright Chromium, Redis, ARQ वर्कर, पोर्ट 3000 पर Next.js और पोर्ट 5000 पर FastAPI लॉन्च करता है। API में हेल्थ, एनालाइज, स्टेटस, रिजल्ट, SSE इवेंट्स, स्क्रीनशॉट, डिलीट, डिजाइन्स लिस्ट और Tailwind, कंपोनेंट्स, design.md और टोकन के लिए एक्सपोर्ट एंडपॉइंट्स शामिल हैं। प्रत्येक विश्लेषण analyses/{id}/ में screenshot.png, screenshot-overlay.png, result.json, DESIGN.md, tailwind.config.js, components.jsx और design-tokens.json लिखता है। MCP सर्वर http://localhost:5000/mcp पर HTTP SSE के माध्यम से या stdio मोड में स्टैंडअलोन उपलब्ध है। एक हल्का uvx CLI, design-oracle-mcp, Playwright/Chromium की आवश्यकता के बिना HTTP के माध्यम से बैकएंड को कॉल करता है। opencode, Cursor और Claude Code के लिए टूल स्निपेट्स दस्तावेजित हैं। एक Cloudflare Tunnel स्क्रिप्ट, start-public.sh, ऐप को एक अस्थायी सार्वजनिक HTTPS URL के माध्यम से एक्सपोज कर सकती है। ज्ञात सीमाएं: विश्लेषण वर्तमान में एकल 1440x900 व्यूपोर्ट का उपयोग करता है; बॉट-सुरक्षित साइटें Playwright को ब्लॉक कर सकती हैं, जिसमें बुनियादी और मध्यम सुरक्षा के लिए एक वैकल्पिक STEALTH_MODE है, हालांकि एंटरप्राइज सुरक्षा के लिए अभी भी CAPTCHA या पेड प्रॉक्सी की आवश्यकता हो सकती है; कंपोनेंट डिटेक्शन ML/विज़न-आधारित होने के बजाय ह्यूरिस्टिक है; और SQLite स्टोरेज स्थानीय या एकल-उपयोगकर्ता उपयोग के लिए उपयुक्त है, मल्टी-टेनेंट परिनियोजन के लिए नहीं।