giselle

the AI agent studio powering product delivery

▶︎▶︎ The YouTube video with audio can be found here ◀︎◀︎

👋 Introduction

Giselle is an open source AI for agentic workflows, enabling seamless human-AI collaboration.

⚡ Quick Start

Get Giselle running locally in 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 and start building your AI agents!

Note: You need at least one AI provider API key. Supported providers: OpenAI, Anthropic, Google AI.

✨ Features

• ⚡ GitHub AI Operations - Automates issues, PRs, and deployments with AI
• 🎨 Visual Agent Builder - Create and modify agents in minutes using an intuitive drag-and-drop interface
• 🤖 Multi-Model Composition - Leverage GPT, Claude, Gemini, and more—agents select the best model for each task
• 📁 Knowledge Store - Access and search your code and data from one place. GitHub vector store integration supported
• 👥 Team Collaboration - Design agents collaboratively with shared configurations and contextual awareness (In Development)
• 🚀 Template Hub - Kickstart projects with one-click agent templates—contributed by the community (In Development)

🎯 Use Cases

• 📚 Research Assistant - Automatically gather information from web and internal docs
• 🔍 Code Reviewer - AI-powered code review that integrates with your GitHub workflow
• 📄 Document Generator - Auto-create PRDs, specs, and release notes from your codebase
• 🔄 Workflow Automator - Chain multiple AI models to handle complex business processes

🚀 Using Giselle

☁️ Cloud

We host Giselle as a cloud service for anyone to use instantly. It has all the same features as the self-hosted version, and includes 30 minutes of free Agent time per month in the free plan.

🏠 Self-hosting

Follow this starter guide to get Giselle running in your environment.

🎵 Vibe Coding Guide

If you're using AI coding assistants like Claude, Cursor, or WindSurf to help build with Giselle, check out our Vibe Coding Guide. This guide explains:

• What is vibe coding and how to approach it effectively
• How to set up your Node.js environment and install dependencies
• Understanding Giselle's project structure
• Running the playground and connecting to LLM providers

Designed for both developers and non-engineers, this guide will help you harness the power of AI to build with Giselle without needing traditional coding expertise.

🗺️ Roadmap

Giselle is currently still in active development. The roadmap for the public repository is currently being created, and once it's finalized, we will update this README accordingly.

🤝 Contributing

Thanks for your interest in Giselle. Here are a few ways you can engage with the project:

• Star this repo ⭐
• Follow us on social media: Facebook, X, Instagram and YouTube
• Report a bug you encounter while using Giselle
• Share an idea or question on GitHub Discussions
• Before opening a pull request for non-trivial changes, please start a discussion so we can align on scope

For details on contributing, please see our contributing guide.

📄 License

Giselle is licensed under the Apache License Version 2.0.

Licenses for third-party packages can be found in docs/packages-license.md.