node-gemini-ai-agent

# 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](https://sanjaysikdar.dev).

## 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 📦

```bash
# Install dependencies
npm install
```

## Configuration ⚙️

1. Get your Google Claude API key from [Google AI Studio](https://aistudio.google.com/app/apikey)
2. Set as environment va