Quick Start
The fastest way to use OpenGPEX is to visit the official cloud service at gpex.cloud to start editing immediately. No setup or installation is required.
If you prefer to run the editor locally or set up a development environment on your own machine, follow the instructions below to get started in under 5 minutes.
Prerequisites
- Node.js 20+ (LTS recommended)
- pnpm 9+ (package manager)
1. Clone the Repository
git clone https://github.com/gpex-cloud/opengpex
cd opengpex
2. Install Dependencies
pnpm install
3. Start the Development Server
pnpm dev
The editor will be available at http://localhost:3030.
4. Load an Image
- Open the editor in your browser
- Drag and drop any image file onto the canvas, or use the file upload button
- Start editing!
5. (Optional) Connect to GPEX-Cloud
All core features of OpenGPEX—including all editing tools, layers, masks, filters, and local workspace persistence—are completely free to use and function fully offline.
However, by signing in to the official cloud service (GPEX-Cloud) via the Cloud menu at the top of the editor, you can obtain online cloud storage to save, sync, and manage your projects across devices. No environment configuration or setup is needed to connect to the official cloud service.
Next Steps
- Editor Overview — Learn the UI and workspace
- Plugin System Overview — Build your first plugin
Last updated: 2026-06-14