ii-agent 的安装和配置教程

1. 项目基础介绍与主要编程语言

ii-agent 是一个开源的智能助手项目，旨在简化和增强跨多个领域的工作流程。它代表了我们在与技术互动方式上的重大进步——从被动的工具转变为能够独立执行复杂任务智能系统。该项目主要使用 Python 编程语言实现，同时也涉及到 Node.js 用于前端部分。

2. 项目使用的关键技术和框架

ii-agent 项目使用了一系列关键技术和框架，主要包括：

• Python：后端逻辑和智能代理的实现。
• Node.js：前端用户界面的开发。
• WebSocket：实现前端与后端之间的实时通信。
• Google Cloud's Vertex AI：提供对 Anthropic 模型的 API 访问。
• React：前端界面框架。
• LLM (Large Language Model)：大型语言模型，用于处理自然语言理解和生成。

3. 项目安装和配置的准备工作与详细步骤

准备工作

在开始安装 ii-agent 项目之前，请确保您的系统中已经安装了以下环境和依赖：

• Python 3.10 或更高版本
• Node.js 18 或更高版本
• Git 用于克隆项目仓库

安装步骤

克隆项目仓库

首先，您需要在您的计算机上克隆 ii-agent 的 Git 仓库：

git clone https://github.com/Intelligent-Internet/ii-agent.git

设置 Python 环境

接下来，为项目设置一个虚拟环境并安装所需的 Python 包：

cd ii-agent
python -m venv .venv
source .venv/bin/activate  # 在 Windows 系统下使用 .venv\Scripts\activate
pip install -e .

设置环境变量

在项目根目录下创建一个 .env 文件，并根据需要填写以下环境变量：

OPENAI_API_KEY=your_openai_key
OPENAI_AZURE_ENDPOINT=your_azure_endpoint
TAVILY_API_KEY=your_tavily_key
JINA_API_KEY=your_jina_key
FIRECRAWL_API_KEY=your_firecrawl_key
SERPAPI_API_KEY=your_serpapi_key
STATIC_FILE_BASE_URL=http://localhost:8000/
ANTHROPIC_API_KEY=your_anthropic_api_key
GOOGLE_APPLICATION_CREDENTIALS=your_google_credentials

配置前端环境

进入前端目录，安装前端依赖：

cd frontend
npm install

创建前端的环境变量文件 .env 在 frontend 目录下，并设置如下变量：

NEXT_PUBLIC_API_URL=http://localhost:8000

运行项目

• 运行 WebSocket 服务器：

  如果使用 Anthropic 客户端：

  export STATIC_FILE_BASE_URL=http://localhost:8000
  python ws_server.py --port 8000
  

  如果使用 Google Vertex：

  export STATIC_FILE_BASE_URL=http://localhost:8000
  python ws_server.py --port 8000 --project-id YOUR_PROJECT_ID --region YOUR_REGION
  

• 在另一个终端中启动前端：

  cd frontend
  npm run dev
  

• 使用浏览器打开 http://localhost:3000 查看前端界面。

以上步骤完成后，ii-agent 项目应该已经成功安装在您的系统中，并准备开始使用了。