How do I develop it locally?

How do I development it on local?

Perfect! Here's a comprehensive guide for setting up Giselle locally:

##Local Development Setup

###📋 Quick Start (Under 2 Minutes)

# Clone the repository
git clone https://github.com/giselles-ai/giselle.git
cd giselle

# Install dependencies
pnpm install

# Create environment file
touch .env.local

# Add your API key (at least one required)
echo 'OPENAI_API_KEY="your_openai_api_key_here"' >> .env.local

# Start development server
pnpm turbo dev

Open http://localhost:3000 in your browser!

###🔧 Prerequisites

You need:

• Node.js - Version 22.14.0 (use NVM for easy installation)
• pnpm - Package manager (install globally: curl -fsSL https://get.pnpm.io/install.sh | sh -)
• At least one AI provider API key (OpenAI, Anthropic, or Google AI)

###🗝️ Environment Variables Setup

Create a .env.local file in the root directory with at least one of these:

# Required (at least one)
OPENAI_API_KEY="your_openai_api_key"

# Optional
ANTHROPIC_API_KEY="your_anthropic_api_key"
GOOGLE_GENERATIVE_AI_API_KEY="your_google_api_key"

###🚀 Running Development Server

# Default: runs on port 3000
pnpm turbo dev

# Custom port (e.g., port 6180)
PORT=6180 pnpm turbo dev

###📁 Project Structure

• Self-hosting version: apps/playground/ (recommended for external contributors)
• Cloud version: apps/studio.giselles.ai/

###💡 Additional Resources

• Vibe Coding Guide - Great for using AI coding assistants while developing
• Node.js Setup Guide - Detailed instructions for installing Node.js with NVM
• Contributing Guide - Full contribution guidelines and PR process

###✨ Key Technologies Used

• Package Manager: pnpm
• Monorepo: Turborepo
• Frontend: Next.js (port 3000)
• Database: Supabase (optional for self-hosting)

That's it! You should now have Giselle running locally. If you run into any issues, check the GitHub Issues or ask in the forums!