HackLens is an advanced AI-powered engine designed to give hackathon participants a competitive edge. By ingesting official event URLs, HackLens cross-references rules, judging criteria, and sponsor technical constraints to blueprint projects with the highest mathematical probability of winning.
- Deep Context Extraction: Automatically scrapes and parses Devpost, Lablab, or GitHub hackathon pages using Gemini 3 Pro with Google Search grounding to find "hidden" rules and judge preferences.
- Winning Pattern Recognition: Benchmarks project ideas against a database of 10,000+ historical winners to identify what specific judges and sponsors actually reward.
- Multi-Modal Blueprints:
- Strategic Tiering: Generates 6 project ideas categorized by risk (Safe, Competitive, High-Risk).
- Visual Mockups: AI-generated isometric product mockups using Gemini 2.5 Flash Image.
- Audio Pitch Pilot: High-energy, 30-second elevator pitches generated via Gemini 2.5 TTS to help teams nail their presentation.
- Project Mentor (ChatBot): A dedicated persistent strategist to help with technical architecture, pitch deck outlines, and last-minute pivot advice.
- Compliance Guard: Explicitly identifies disqualification criteria and required technical SDKs/APIs to ensure teams never lose on a technicality.
- Framework: React (Functional Components + Hooks)
- Styling: Tailwind CSS (Dark Mode Aesthetic)
- AI Engine: Google Gemini API
gemini-3-pro-preview: Reasoning, extraction, and strategic brainstorming.gemini-2.5-flash-image: Product mockup generation.gemini-2.5-flash-preview-tts: Audio pitch generation.gemini-flash-lite-latest: Low-latency strategic tips.
- Networking: ESM modules via
esm.shfor zero-install browser execution.
- A Google Gemini API Key.
- Clone the repository.
- Ensure you have an environment variable
API_KEYconfigured in your hosting environment. - Open
index.htmlin a modern browser.
- Input: Paste a hackathon landing page URL.
- Analysis: The engine scours the web to build a "Truth Document" of the event.
- Selection: Choose a specific prize track or the general pool.
- Blueprint: Receive 6 fully fleshed-out project roadmaps.
- Visualize & Pitch: Generate mockups and listen to pitches to validate the "vibe" of your project before writing a single line of code.
- Safe: High feasibility, solves a clear problem mentioned in the hackathon description. Great for first-timers.
- Competitive: High innovation, utilizes sponsor tech heavily, targets the "Impact" judging category.
- High-Risk: Moonshot ideas. High technical complexity. Designed for the "Overall Winner" or "Most Innovative" categories.
Disclaimer: HackLens is a strategic tool. Success depends on the team's execution and the quality of their code.