🦸 Avengers AI Assistant

An intelligent Marvel Cinematic Universe chatbot that provides information about MCU movies, their connections, viewing orders, and personalized recommendations.

✨ Features

• 💬 Interactive Chat Interface - Marvel-themed conversational UI
• 🎬 Complete MCU Database - Information about all MCU movies
• 📅 Watch Orders - Chronological and release order viewing guides
• 🔗 Movie Connections - Discover how films relate to each other
• 🎯 Smart Recommendations - Personalized movie suggestions
• 🚀 Auto-Backend Startup - Backend starts automatically with frontend

🛠️ Tech Stack

• Frontend: React + TypeScript + Vite + Tailwind CSS + shadcn/ui
• Backend: Python + Flask + CORS
• Deployment: Docker, Vercel, Render, Netlify ready

🚀 Quick Start

Development (One Command!)

# Install dependencies
npm install

# Start everything (frontend + backend automatically)
npm run dev

That's it! The app will be running at:

• Frontend: http://localhost:8080
• Backend: http://localhost:5000 (auto-started)

Manual Setup (If needed)

Backend:

cd src/backend
pip install -r requirements.txt
python api.py

Frontend:

npm install
npm run dev

📦 Production Deployment

Deploy on vercel: Run this command in the terminal before clicking on the link

npm run dev

Click on the link: https://mcu-chatbot-svf4-8fhbr3c3a-greeshmargowda2-7172s-projects.vercel.app/

🎯 Production Ready

✅ Automatic Environment Detection - Works in dev and production
✅ Docker Support - Single container deployment
✅ Zero Configuration - API routes auto-configured
✅ Production WSGI - Uses Gunicorn for production
✅ Platform Agnostic - Deploy anywhere

🔧 Configuration

The app automatically detects its environment:

Development Mode:

• Frontend connects to http://localhost:5000/api
• Debug mode enabled

Production Mode:

• Frontend uses same-origin /api routes
• Production-optimized settings
• Gunicorn WSGI server

No manual configuration needed! 🎉

📝 Available Scripts

• npm run dev - Start development server (auto-starts backend)
• npm run build - Build for production
• npm run preview - Preview production build locally
• npm run lint - Run ESLint

🏗️ Project Structure

avengers-ai-assistant/
├── src/
│   ├── components/      # React components
│   ├── hooks/          # Custom React hooks
│   ├── pages/          # Page components
│   ├── backend/        # Flask API
│   │   ├── api.py     # Main API file
│   │   ├── marvel_data.py  # MCU database
│   │   └── requirements.txt
│   └── config.ts       # API configuration
├── vite-plugin-flask.ts  # Auto-backend plugin
├── Dockerfile          # Container config
├── nginx.conf         # Reverse proxy config
└── deployment configs  # Vercel, Render, Netlify

🤝 Contributing

Contributions are welcome! This project uses:

• TypeScript for type safety
• ESLint for code quality
• Prettier for formatting

📄 License

This project is open source and available under the MIT License.

🎊 Acknowledgments

• Built with React, Vite, and Flask
• UI components from shadcn/ui
• Marvel Cinematic Universe data

---