👋 简介

Giselle是一款面向代理式工作流的开源AI工具，能够实现人与AI之间的无缝协作。

⚡ 快速入门

在不到2分钟内即可在本地运行Giselle：

# 克隆仓库
git clone https://github.com/giselles-ai/giselle.git
cd giselle

# 安装依赖
pnpm install

# 创建环境文件
touch .env.local

# 添加你的API密钥（至少需要一个）
echo 'OPENAI_API_KEY="your_openai_api_key_here"' >> .env.local

# 启动开发服务器
pnpm turbo dev

打开http://localhost:3000，开始构建你的AI智能体吧！

注意：你需要至少一个AI提供商的API密钥。支持的提供商包括：OpenAI、Anthropic、Google AI。

✨ 功能

• ⚡ GitHub AI运维 - 使用AI自动化处理问题、拉取请求和部署
• 🎨 可视化智能体构建器 - 通过直观的拖放界面，几分钟内即可创建和修改智能体
• 🤖 多模型组合 - 利用GPT、Claude、Gemini等模型——智能体会为每项任务选择最佳模型
• 📁 知识库 - 从一处访问和搜索代码及数据。支持GitHub向量存储集成
• 👥 团队协作 - 通过共享配置和上下文感知功能，协同设计智能体 (正在开发中)
• 🚀 模板中心 - 一键启动项目，使用社区贡献的智能体模板 (正在开发中)

🎯 应用场景

• 📚 研究助理 - 自动从网络和内部文档中收集信息
• 🔍 代码审查员 - 集成到GitHub工作流中的AI驱动代码审查
• 📄 文档生成器 - 根据代码库自动生成PRD、规格说明和发布说明
• 🔄 工作流自动化 - 将多个AI模型串联起来，以处理复杂的业务流程

🚀 使用Giselle

☁️ 云端

我们以云服务的形式托管了Giselle，任何人都可以立即使用。它具备与自托管版本完全相同的功能，并且免费计划每月提供30分钟的智能体使用时间。

🏠 自托管

请按照这份入门指南来在你的环境中运行Giselle。

🎵 Vibe编码指南

如果你正在使用Claude、Cursor或WindSurf等AI编码助手来帮助你基于Giselle进行开发，请查看我们的Vibe编码指南。本指南将介绍：

• 什么是vibe编码以及如何有效地进行操作
• 如何设置Node.js环境并安装依赖
• 理解Giselle的项目结构
• 运行游乐场并与LLM提供商连接

该指南专为开发者和非工程师设计，旨在帮助你无需传统编码技能即可利用AI的力量，基于Giselle进行开发。

🗺️ 路线图

Giselle目前仍在积极开发中。公共仓库的路线图正在制定中，一旦确定，我们将相应地更新此README文件。

🤝 贡献

无论大小，您的贡献都有助于 Giselle 的发展与改进。您有兴趣加入我们吗？

以下是您可以参与贡献的方式：

• 为本仓库点个赞 ⭐
• 关注我们的社交媒体：Facebook、X、Instagram 和 YouTube
• 报告错误，如果您在使用 Giselle 时遇到问题
• 请求功能，如果您认为某项功能会很有帮助
• 提交拉取请求，如果您希望添加新功能或修复 bug

更多详情，请参阅我们的贡献指南。

📄 许可证

Giselle 采用 Apache License Version 2.0 许可证。

第三方软件包的许可证信息可在 docs/packages-license.md 中找到。

Giselle 快速上手指南

Giselle 是一个开源的 AI 智能体（Agent）工作室，旨在通过可视化的拖拽界面和强大的多模型组合能力，实现流畅的人机协作与工作流自动化。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：macOS, Linux 或 Windows (WSL2 推荐)
• Node.js：建议安装最新 LTS 版本 (v18+)
• 包管理器：必须安装 pnpm (项目依赖管理工具)

  npm install -g pnpm
  

• API 密钥：至少需要一个主流大模型提供商的 API Key，支持：
  • OpenAI
  • Anthropic (Claude)
  • Google AI (Gemini)

提示：国内开发者若遇到网络问题，建议在配置环境变量时通过代理访问相关 API 服务，或在 pnpm 配置中使用国内镜像源加速依赖下载。

安装步骤

只需几分钟即可在本地启动 Giselle：

1. 克隆仓库

   git clone https://github.com/giselles-ai/giselle.git
   cd giselle
   

2. 安装依赖

   pnpm install
   

3. 配置环境变量 创建本地环境文件并填入您的 API Key（以下以 OpenAI 为例，也可替换为 ANTHROPIC_API_KEY 或 GOOGLE_GENERATIVE_AI_API_KEY）：

   touch .env.local
   echo 'OPENAI_API_KEY="your_openai_api_key_here"' >> .env.local
   

4. 启动开发服务器

   pnpm turbo dev
   

启动成功后，终端会显示服务地址。

基本使用

1. 访问界面 打开浏览器访问 http://localhost:3000。

2. 构建第一个智能体

   • 进入可视化编辑器界面。
   • 从左侧组件栏拖拽节点（如 LLM 模型、知识库检索、代码执行等）到画布。
   • 连接节点以定义工作流逻辑。
   • 在右侧面板配置具体参数（如选择模型类型、输入 Prompt）。

3. 运行与测试 点击界面上的“运行”按钮，即可实时查看 AI 智能体的执行结果。您可以尝试创建一个简单的“代码审查助手”或“文档生成器”工作流来体验其功能。

---

更多高级用法（如 GitHub 集成、团队协作配置）请参考项目根目录下的 CONTRIBUTING.md 或官方 Vibe Coding 指南。