Giselle：面向本地与自托管的开源 AI 工作流工具

👋 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

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