PySpur开源项目安装与配置指南

PySpur开源项目安装与配置指南

pyspur Minimalist AI Agent Graph UI 项目地址: https://gitcode.com/gh_mirrors/py/pyspur

1. 项目基础介绍

PySpur 是一个用于迭代 AI 代理的视觉操场，它允许 AI 工程师在不重新发明轮子的情况下，通过图形界面快速迭代 AI 代理。该项目致力于解决 AI 工程师在构建代理时遇到的三大问题：Prompt Hell（提示地狱）、Workflow Blindspots（工作流盲点）和 Terminal Testing Nightmare（终端测试噩梦）。PySpur 提供了一个视觉工作流构建器，可以帮助用户定义测试用例、构建代理、迭代优化，并一键部署。

该项目主要使用的编程语言是 TypeScript 和 Python。

2. 关键技术和框架

PySpur 使用了以下关键技术和框架：

• TypeScript：用于构建前端界面，提供类型安全的开发体验。
• Python：用于后端逻辑的实现，与 TypeScript 前端进行交互。
• React：用于构建用户界面。
• Docker：用于容器化应用，简化部署过程。
• GitHub Actions：用于自动化构建和测试流程。

3. 安装和配置准备工作

在开始安装 PySpur 之前，请确保您的系统中已安装以下工具：

• Node.js：建议使用最新版本的 Node.js，以确保兼容性。
• Python：建议安装 Python 3.11 或更高版本。
• Docker：用于运行容器化应用。
• Git：用于克隆和操作项目代码。

详细安装步骤

1. 克隆项目仓库：

   git clone https://github.com/PySpur-Dev/pyspur.git
   cd pyspur
   

2. 安装项目依赖：

   npm install
   pip install -r requirements.txt
   

3. 配置环境变量：

   在项目根目录下创建一个 .env 文件，并添加以下内容：

   DATABASE_URL=postgres://username:password@localhost:5432/pyspur
   

   替换 username 和 password 为您的 PostgreSQL 用户名和密码。

4. 构建和启动 Docker 容器：

   docker-compose -f docker-compose.dev.yml up --build -d
   

5. 启动 PySpur 服务：

   pyspur serve --sqlite
   

   默认情况下，PySpur 应用将在 http://localhost:6080 上运行。

6. (可选) 配置 API 密钥：

   在应用 UI 中导航到 API 密钥选项卡，添加提供商密钥（例如 OpenAI、Anthropic 等）。

完成以上步骤后，您应该能够访问 PySpur 应用并开始使用其功能。如果有任何问题，请参考项目的 README.md 文件或搜索相关社区支持。

pyspur Minimalist AI Agent Graph UI 项目地址: https://gitcode.com/gh_mirrors/py/pyspur