Skip to main content

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.

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.

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.
See the Environment Setup page for step-by-step instructions on creating each set of credentials.

Setup Steps

1

Clone the repository

Download the source code and navigate into the project directory:
git clone https://github.com/nayalsaurav/Akari-Art.git && cd Akari-Art
2

Install dependencies

Install all Node.js dependencies using your preferred package manager:
npm install
3

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
# Google OAuth (NextAuth.js)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# NextAuth.js
NEXTAUTH_SECRET=
NEXTAUTH_URL=

# MongoDB
MONGODB_URL=

# Cloudinary
CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=

# Cloudflare Workers AI
CLOUDFLARE_ID=
CLOUDFLARE_API_KEY=

# Application
NEXT_PUBLIC_BASE_URL=
4

Start the development server

Launch the Next.js development server:
npm run dev
The server starts on http://localhost:3000 by default.
5

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.
The npm run dev script (and its equivalents for other package managers) already includes the --turbopack flag — next dev --turbopack — so Turbopack is enabled by default. You benefit from significantly faster hot-module replacement without any extra configuration.

Build docs developers (and LLMs) love