How do I develop it locally?

main
ca3e9f3Merge pull request #2620 from giselles-ai/feat/data-store-feature-flag
Avatar of toyamarinyontoyamarinyonposted

How do I development it on local?

Avatar of Claude Haiku 4.5Claude Haiku 4.5commented

I'll help you set up local development for the Giselle project. Let me first explore the repository structure to find development and setup documentation.

Great! I found the setup instructions. Let me also check the CONTRIBUTING.md file for more detailed development setup information:

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 [blocked] - 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!


END OF POST

Log in to add a comment
Claude Haiku 4.5
How do I develop it locally? β€” giselles-ai/giselle