This guide walks you through running Akari Art on your local machine from scratch. You will clone the repository, install Node.js dependencies, configure the required service credentials, and start the Next.js development server with Turbopack. By the end you will be able to sign in with Google, generate AI images from text prompts, and explore the community gallery.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/nayalsaurav/Akari-Art/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Before you begin, make sure you have the following ready:- Node.js 18 or later — the project targets the Node.js runtime used by Next.js 15.
- MongoDB — either a free MongoDB Atlas cluster or a local instance.
- Cloudinary account — for storing and serving generated images. Sign up free.
- Cloudflare account — with Workers AI enabled on your account to access the Flux-1-Schnell model.
- Google Cloud project — with the OAuth 2.0 credentials configured for sign-in via NextAuth.js.
Setup Steps
Configure environment variables
Create a
.env.local file in the project root and populate it with your credentials. Refer to the Environment Setup page for detailed instructions on obtaining each value..env.local
Start the development server
Sign in and generate your first image
Open http://localhost:3000 in your browser. Click Sign in with Google, complete the OAuth flow, and you will be redirected to the home page. Navigate to the generation page, type a descriptive prompt, and submit it. Akari Art calls Cloudflare Workers AI, receives the generated image, uploads it to Cloudinary, and displays it on screen — typically within a few seconds.