README.md

---
title: Comic Genesis AI
emoji: 🎨
colorFrom: purple
colorTo: pink
sdk: docker
app_port: 7860
---

# 🎨 Manga Genesis AI

A professional AI-powered manga generator that transforms story ideas into stunning visual narratives using authentic Japanese manga styles and Google's Gemini AI technology.

## ✨ Features

### 🚀 **Professional Manga Creation**
- **Advanced AI Storytelling**: Enhanced narrative structure analysis with genre-specific templates
- **Intelligent Panel Composition**: Dynamic layouts optimized for visual storytelling
- **Character Development**: Multi-dimensional character profiles with consistency tracking
- **Professional Art Styles**: Shonen, Shojo, Seinen, and Chibi manga aesthetics

### 🎭 **Story Templates**
- **Hero's Journey**: Classic adventure narratives with character transformation
- **Mystery Thriller**: Suspenseful investigations with plot twists
- **Slice of Life**: Character-driven everyday moments
- **Sci-Fi Adventure**: Futuristic worlds with advanced technology
- **Romance Drama**: Emotional love stories with obstacles
- **Custom Story**: Complete creative freedom

### 🎨 **Modern Interface**
- **Glass Morphism Design**: Sleek, professional dark theme with backdrop blur effects
- **Interactive Elements**: Smooth animations and hover effects
- **Responsive Layout**: Optimized for desktop and mobile devices
- **Real-time Progress**: Visual feedback during comic generation

## 🔑 Setup Instructions

1. **Get your API key**: Visit [Google AI Studio](https://makersuite.google.com/app/apikey) to get your free Gemini API key
2. **Enter your story**: Describe your manga story idea
3. **Choose template and style**: Select from professional story structures and art styles
4. **Generate**: Create your manga with AI-powered storytelling
5. **Download**: Export as high-quality PDF

## 🎯 How It Works

1. **Choose a Template**: Select from professional story structures or start custom
2. **Craft Your Story**: Use the interactive editor with writing tips and guidance
3. **Select Art Style**: Choose from authentic Japanese manga aesthetics
4. **AI Generation**: Advanced algorithms create character profiles and panel layouts
5. **Visual Creation**: Google Gemini generates professional manga pages
6. **Download**: Export your manga as a high-quality PDF

## 🧠 Advanced Features

### **Narrative Structure Analysis**
- Automatic story pattern detection
- Genre-specific beat planning
- Character arc development
- Emotional pacing optimization

### **Professional Panel Composition**
- Dynamic layout analysis based on story content
- Style-specific visual arrangements
- Proper manga flow and reading patterns (right-to-left)
- Visual hierarchy optimization

### **Character Consistency**
- Multi-dimensional character profiles
- Visual trait consistency across panels
- Personality-driven design elements
- Relationship dynamics integration

## 🎨 Technology Stack

- **Frontend**: React 19 + TypeScript
- **Styling**: Modern Glass Morphism Design
- **AI Engine**: Google Gemini 2.5 Flash + Image Preview
- **Build Tool**: Vite 6
- **Container**: Docker
- **PDF Generation**: Built-in export functionality

## 🚀 Local Development

```bash
# Clone the repository
git clone <your-repo-url>
cd comic-book-generator-2

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview
```

## 🐳 Docker Deployment

```bash
# Build the Docker image
docker build -t manga-genesis-ai .

# Run the container
docker run -p 7860:7860 manga-genesis-ai
```

## 📝 License

This project is licensed under the MIT License.

---

**🎨 Transform your stories into authentic manga masterpieces with Manga Genesis AI!**