System Requirements for Running awesome-gpt-image-2: Complete Setup Guide

To run awesome-gpt-image-2 locally, you need Node.js 14+, npm or Yarn, a modern evergreen browser, and valid Supabase credentials configured in your environment variables.

awesome-gpt-image-2 is a modern React application built with Vite that connects to a Supabase back-end and multiple third-party image generation APIs. This guide covers every technical requirement and configuration step needed to get the application running on your local machine based on the source code in the freestylefly/awesome-gpt-image-2 repository.

Core Runtime Dependencies

Node.js Version Requirements

The application requires Node.js 14 LTS or higher. While the package.json file does not explicitly pin a Node version, the project uses Vite as its build tool, which mandates Node 14+ for proper operation.

You can verify your Node version before installation:

node --version

If your version is below 14, download the latest LTS release from the official Node.js website or use a version manager like nvm.

Package Manager Options

You can use either npm (included with Node.js) or Yarn to install dependencies. The repository defines standard npm scripts in package.json that handle development, building, and previewing:

"scripts": {
  "dev": "vite",
  "build": "vite build",
  "preview": "vite preview"
}

Browser Compatibility Requirements

awesome-gpt-image-2 targets modern browsers using React 18 and Vite 4. According to the vite.config.js configuration, supported browsers include:

• Chrome ≥ 89
• Firefox ≥ 86
• Edge ≥ 89
• Safari ≥ 14

The application uses ES modules and modern JavaScript features that require an evergreen browser to render the UI correctly.

Backend and API Configuration

Supabase Project Setup

The front-end relies on a Supabase back-end for data persistence and authentication. You must create a Supabase project and configure the client in src/supabaseClient.js.

The application expects two environment variables declared in .env.example:

NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

Without these credentials, the application will fail to initialize the Supabase client and cannot perform database operations.

Third-Party API Keys (Optional but Required for Generation)

To use the hosted image-generation features, you must provide credentials for at least one supported provider. The .env.example file lists the available API configuration options:

• APIMart
• hiAPI
• PackyCode
• PPToken
• Liqiu API

While the application will start without these keys, the core image generation functionality will be unavailable until you configure at least one provider.

Environment Setup and Installation

Follow these steps to configure your local environment based on the repository structure:

1. Clone the repository

git clone https://github.com/freestylefly/awesome-gpt-image-2.git
cd awesome-gpt-image-2

2. Install dependencies

npm install

# or

yarn install

3. Configure environment variables

Copy the example file and fill in your credentials:

cp .env.example .env

Edit .env to include your Supabase URL, anonymous key, and any third-party API keys you intend to use.

4. Start the development server

npm run dev

Vite will start the development server, typically available at http://localhost:5173 as configured in vite.config.js.

5. Build for production (optional)

npm run build
npm run preview

Summary

• Node.js 14+ and npm/Yarn are required to install dependencies and run the Vite build system.
• A modern evergreen browser (Chrome 89+, Firefox 86+, Safari 14+) is necessary to render the React 18 interface.
• Supabase credentials are mandatory; the app reads NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY from environment variables defined in .env.example.
• Third-party API keys enable image generation features but are optional for basic application startup.
• No Docker or additional OS-level dependencies are required for local development.

Frequently Asked Questions

What Node.js version do I need for awesome-gpt-image-2?

You need Node.js 14 LTS or higher. The package.json does not enforce a specific version, but Vite—the build tool used in vite.config.js—requires Node 14+. Newer versions (16, 18, or 20) are fully compatible and recommended for better performance.

Can I run awesome-gpt-image-2 without Supabase?

No, Supabase is a mandatory dependency. The application imports src/supabaseClient.js as its database and authentication layer. Without valid NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY environment variables, the React application will fail to initialize properly.

Which browsers support awesome-gpt-image-2?

The application supports Chrome 89+, Firefox 86+, Edge 89+, and Safari 14+. These requirements stem from the Vite configuration and React 18's modern JavaScript feature requirements. Older browsers lack the ES module support needed to execute the bundled code.

Do I need Docker to run this project?

No, Docker is optional. You can run awesome-gpt-image-2 directly on any operating system that supports Node.js (Linux, macOS, or Windows) by following the standard npm install and npm run dev workflow. Docker is only useful if you prefer containerized deployment or need to standardize environments across a team.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}