<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](https://www.youtube.com/watch?v=g1siFWk0GNs) ◀︎◀︎


  <!-- 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 for agentic workflows, enabling seamless human-AI collaboration.



## ⚡ Quick Start

Get Giselle running locally in under 2 minutes:

```bash
# 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](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;">&nbsp;&nbsp;&nbsp;
<img src="./docs/assets/featured/pdt2.png" width="100" alt="Visual Agent Builder" style="margin-right: 25px;">&nbsp;&nbsp;&nbsp;
<img src="./docs/assets/featured/pdt3.png" width="100" alt="Multi-Model Composition" style="margin-right: 25px;">&nbsp;&nbsp;&nbsp;
<img src="./docs/assets/featured/pdt4.png" width="100" alt="Knowledge Store" style="margin-right: 25px;">&nbsp;&nbsp;&nbsp;
<img src="./docs/assets/featured/pdt5.png" width="100" alt="Team Collaboration" style="margin-right: 25px;">&nbsp;&nbsp;&nbsp;
<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

### ☁️ Cloud

We host [Giselle](https://giselles.ai/) 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](CONTRIBUTING.md#development-environment-setup) 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](/docs/vibe/01-introduction.md). 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](https://www.facebook.com/GiselleAI/), [X](https://x.com/Giselles_AI), [Instagram](https://www.instagram.com/giselle_de_ai) and [YouTube](https://www.youtube.com/@Giselle_AI)
- [Report a bug](https://github.com/giselles-ai/giselle/issues/new?template=1_bug_report.yml) you encounter while using Giselle
- [Share an idea or question](https://github.com/giselles-ai/giselle/discussions) 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](CONTRIBUTING.md).

## 📄 License

Giselle is licensed under the [Apache License Version 2.0](LICENSE).

Licenses for third-party packages can be found in [docs/packages-license.md](docs/packages-license.md).
