--- slug: "giselle" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/giselles-ai/giselle@main/README.md" repo: "https://github.com/giselles-ai/giselle" source_file: "README.md" branch: "main" ---

the AI agent studio powering product delivery

▶︎▶︎ [The YouTube video with audio can be found here](https://www.youtube.com/watch?v=g1siFWk0GNs) ◀︎◀︎ Giselle Demo

## 👋 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

- **⚡ 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](https://github.com/giselles-ai/giselle/blob/HEAD/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](https://github.com/giselles-ai/giselle/blob/HEAD/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 For details on contributing, please see our [contributing guide](https://github.com/giselles-ai/giselle/blob/HEAD/CONTRIBUTING.md). ## 📄 License Giselle is licensed under the [Apache License Version 2.0](https://github.com/giselles-ai/giselle/tree/HEAD/LICENSE). Licenses for third-party packages can be found in [docs/packages-license.md](https://github.com/giselles-ai/giselle/blob/HEAD/docs/packages-license.md).