Giselle AI Agent

<div align="center">

<a href="https://github.com/giselles-ai/giselle"><img src="https://img.shields.io/github/stars/giselles-ai/giselle.svg?style=social&label=Star" alt="GitHub stars" style="margin-right: 5px;"></a> <img src="https://img.shields.io/badge/License-Apache2.0-blue.svg" alt="License" style="margin-right: 5px;">

<img src="./docs/assets/giselle-logo-light.svg#gh-light-mode-only" alt="Giselle logo" height="100"> <img src="./docs/assets/giselle-logo-dark.svg#gh-dark-mode-only" alt="Giselle logo" height="100">

<span style="font-size: 18px; color: #666; margin-left: 15px;">the AI agent studio powering product delivery</span>

<p> <a href="https://www.producthunt.com/products/giselle?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-giselle" target="_blank" rel="noopener noreferrer"><img alt="Giselle - Build and run AI workflows. Open source. | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=924550&amp;theme=light&amp;period=daily&amp;t=1767082208449"></a> <a href="https://www.producthunt.com/products/giselle?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-giselle" target="_blank" rel="noopener noreferrer"><img alt="Giselle - Build and run AI workflows. Open source. | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=924550&amp;theme=light&amp;t=1767667659741"></a> <a href="https://www.producthunt.com/products/giselle?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-giselle" target="_blank" rel="noopener noreferrer"><img alt="Giselle - Build and run AI workflows. Open source. | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=924550&amp;theme=light&amp;period=weekly&amp;t=1767667659741"></a> </p> <!-- Demo Video -->

<img src="./docs/assets/introducing.gif" alt="Giselle Video" width="100%"> <br/>

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

<!-- Light/Dark Mode GIFs -->

<img src="./docs/assets/copy-light.gif#gh-light-mode-only" alt="Giselle Demo" width="400"> <br/> <img src="./docs/assets/copy-dark.gif#gh-dark-mode-only" alt="Giselle Demo" width="400">

</div>

👋 Introduction

Giselle is an open-source AI workflow tool focused on local and self-hosted use, 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

<div align="center">

<img src="./docs/assets/featured/pdt1.png" width="100" alt="GitHub AI Operations" style="margin-right: 25px;">    <img src="./docs/assets/featured/pdt2.png" width="100" alt="Visual Agent Builder" style="margin-right: 25px;">    <img src="./docs/assets/featured/pdt3.png" width="100" alt="Multi-Model Composition" style="margin-right: 25px;">    <img src="./docs/assets/featured/pdt4.png" width="100" alt="Knowledge Store" style="margin-right: 25px;">    <img src="./docs/assets/featured/pdt5.png" width="100" alt="Team Collaboration" style="margin-right: 25px;">    <img src="./docs/assets/featured/pdt6.png" width="100" alt="Template Hub">

</div>

• ⚡ 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

Giselle is available as open source for local use and self-hosting. The hosted cloud service has been discontinued.

🏠 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

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.