首页
/ ii-agent 的安装和配置教程

ii-agent 的安装和配置教程

2025-05-21 16:34:11作者:钟日瑜

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

创建前端的环境变量文件 .envfrontend 目录下,并设置如下变量:

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 项目应该已经成功安装在您的系统中,并准备开始使用了。

登录后查看全文
热门项目推荐
相关项目推荐