An intelligent AI agent powered by Google's Gemini API that can build complete websites based on natural language descriptions. Demo: https://youtu.be/3jdWDY8YHu4

AI Website Builder Agent 🌐

An intelligent AI agent powered by Google's Gemini API that can build complete websites based on natural language descriptions.

Created by Sanjay Sikdar.

Key Features Covered ✨

• Natural Language Interface — Just describe what you want, and the agent builds it.
• Command Execution System (⚙️) — Secure shell/terminal command execution with safety filters, validation and a 30-second timeout. (Exposed via the executeCommand tool.)
• File Operations (📁) — Read, write, and list files using modern fs/promises APIs (readFile, writeFile, listFiles).
• Persistent Chat Memory (📚) — Keeps conversational context for up to 20 messages with automatic trimming to stay within token limits.
• Modify Existing Components (🧱) — Edit HTML, CSS, or JS parts dynamically without breaking the overall document structure.
• Smart Code Generation — Produces clean, modern, responsive website scaffolds and component code.
• Rate Limiting + Retry Logic (⏳) — Built-in 2s delay between API calls plus automatic retries with exponential backoff (e.g., 5s, 15s, 30s), up to 3 retries for quota errors.
• Error Handling (🔒) — Robust handling with smart fallbacks for timeouts, authentication issues and other common failures.
• Image Placeholder Management (🖼️) — Uses services like picsum.photos and dummyimage.com for image placeholders during scaffolding.
• Cross-Platform Support (🖥️) — Works on Windows, macOS, and Linux (handles path and shell differences).
• Enhanced UX — Beautiful console output with emojis, progress indicators and clear retry/error messages.
• Security Features — Blocks dangerous commands and enforces command validation policies.

Installation 📦

# Install dependencies
npm install

Configuration ⚙️

1. Get your Google Claude API key from Google AI Studio
2. Set as environment va