Quick Start

Project Overview

ioy.ai is an intelligent image generation and editing platform powered by Qwen-Image, built with Next.js 15 and React 19, providing a modern AI-driven creative experience.

Local Development

Prerequisites

Node.js 20+
pnpm
PostgreSQL database

Installation

# Clone the repository
git clone https://github.com/lvyinchao/ioyai.git
cd ioyai

# Install dependencies
pnpm install

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

# Setup database
pnpm db:push

# Start development server
pnpm dev

Environment Configuration

Configure the following environment variables in your .env.local file:

# Database Configuration
DATABASE_URL="postgresql://username:password@localhost:5432/ioyai"

# NextAuth Configuration
NEXTAUTH_SECRET="your-secret-key"
NEXTAUTH_URL="http://localhost:3000"

# Qwen AI Configuration
QWEN_API_KEY="your-qwen-api-key"

# Stripe Payment Configuration (Optional)
STRIPE_SECRET_KEY="your-stripe-secret-key"
STRIPE_PUBLISHABLE_KEY="your-stripe-publishable-key"

Project Structure

src/
├── app/              # Next.js App Router pages
│   ├── [locale]/     # Internationalized routes
│   └── api/          # API routes
├── components/       # React components
│   ├── blocks/       # Layout block components
│   └── ui/           # UI components
├── contexts/         # React contexts
├── i18n/            # Internationalization
├── lib/             # Utility libraries
├── models/          # Data models
├── services/        # Business logic
└── types/           # TypeScript type definitions

Key Features

Intelligent Image Generation: Text-to-Image generation powered by Qwen-Image
Image Editing Tools: Various AI-driven image processing capabilities
User Authentication: Complete user registration, login, and authorization
Internationalization: Support for English and Chinese interfaces
Responsive Design: Optimized for desktop and mobile devices

Getting Started

Register an account and sign in
Enter image description in the creation page
Select image style and parameters
Click generate button and wait for AI creation
Use editing tools to optimize image effects
Save and share your artwork

Deployment

Vercel Deployment

# Install Vercel CLI
npm i -g vercel

# Deploy to Vercel
vercel --prod

Docker Deployment

# Build Docker image
pnpm docker:build

# Run container
docker run -p 3000:3000 ioyai

Technical Support

For technical support, please contact us through:

GitHub Issues: https://github.com/lvyinchao/ioyai/issues
Email: support@ioy.ai
Discord: Join our community

Quick Start

On this page