README.md

🔥 WEB.BUILDING.GENIOUS

AI-powered software engineering and website generation agent

---

📌 Table of Contents

• Quick Deploy
• Features
• Quick Start
• Environment Variables
• Docker
• Tech Stack
• Local Development
• Build & Start
• AI Agent Capabilities
• Cost Estimates
• License

---

🚀 Quick Deploy

---

✨ Features

• Multi-AI support: OpenAI, OpenRouter, Groq, Grok
• Generates full websites (HTML/CSS/JS)
• Supabase + MongoDB storage
• Upload/download chat history & export HTML
• Tailwind CSS with light/dark themes
• Ready for Vercel & HuggingFace Spaces

---

🛠️ Quick Start

# Clone repository
git clone https://github.com/MadScientist85/WEB.BUILDING.GENIOUS
cd WEB.BUILDING.GENIOUS

# Install dependencies
npm install

# Copy environment file
cp .env.example .env.local

# Add your API keys to .env.local
npm run dev


---

📋 Environment Variables

NEXT_PUBLIC_SUPABASE_URL (required)

SUPABASE_SERVICE_ROLE_KEY (required)

AI API keys (OPENAI_API_KEY, OPENROUTER_API_KEY, etc.)

Optional: MONGODB_URI



---

🐳 Docker

docker build -t web.building.genious .
docker run -p 3000:3000 --env-file .env.local web.building.genious
docker-compose up -d


---

🔧 Tech Stack

Frontend: Next.js 14, React, Tailwind CSS

Backend: Next.js API Routes, Vercel AI SDK

Database: Supabase + MongoDB

AI: OpenAI, OpenRouter, Groq, Grok

Deployment: Vercel, HuggingFace Spaces



---

📝 Local Development

yarn install
yarn dev


---

📦 Build & Start

yarn build
yarn start


---

🎯 AI Agent Capabilities

Generate complete websites with HTML/CSS/JavaScript

Debug and fix code issues

Create database schemas and migrations

Build REST APIs and integrations

Provide architectural recommendations

Generate documentation and guides



---

📊 Cost Estimates

Free Tier: Supabase + Groq + Vercel = $0/month

Basic Usage: ~$5-20/month with OpenAI

Heavy Usage: $20-100/month depending on AI calls



---

📄 License

MIT License - see LICENSE for details

---