企业官网建设流程全解析

Eigent 多智能体工作流系统安装指南：三步跑起来并完成模型配置

【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent

Eigent 是一个开源的多智能体工作流桌面系统：浏览器、终端、文档、开发者等多个智能体在你的电脑上并行干活，你负责派活，它负责执行。你可以接自己的模型 API，也可以本地部署后端，数据留在自己机器里。这篇教程带你从零把它装好、跑起来，并把第一个模型连上。

图：Eigent 的多智能体工作台，每个卡片代表一类可独立调用的智能体

环境准备：先核对这 4 项硬件与依赖

启动前把下面这张表过一遍，缺哪项补哪项：

[!WARNING] 内存低于 8GB 或磁盘不够时，多个智能体并行执行容易卡顿甚至中途失败；跑本地模型（vLLM、Ollama 等）还会额外占用显存和内存，建议按推荐配置准备。

最快启动路径：三步完成安装与启动

下面是官方 Quick Start（云端模式）的路径，全程只需 Node 环境，不需要 Python。

第 1 步：拿到代码

# 克隆仓库并进入目录 git clone https://gitcode.com/GitHub_Trending/ei/eigent cd eigent

怎么算成功：目录下能看到backend/、server/、src/、package.json这几个关键路径。

第 2 步：安装前端依赖

# 安装 Node 依赖（package.json 中已锁定版本） npm install

怎么算成功：命令正常退出、无 ERESOLVE 之类的报错，且生成了node_modules/目录。

第 3 步：启动应用

# 启动开发模式，会先清理 Vite 缓存再拉起前端 npm run dev

怎么算成功：终端出现 Vite 就绪提示，应用窗口自动弹出（默认连接 Eigent 云服务，需要你注册账号登录）：

图：npm run dev成功后的应用窗口，窗口能打开即代表前后端链路已通

[!TIP] 如果你不想用云服务、要求数据全部留在本机，可以改走本地部署路线：在server/目录用 Docker Compose 起 FastAPI + PostgreSQL 后端，再让前端指向http://localhost:3001，完整步骤见 server/README_EN.md。

首次配置：以 Gemini 为例接入你的第一个模型

应用跑起来后，模型还没接上，先走一次完整配置。以 Google Gemini 为例：

1. 进入设置：在应用内点击设置入口，打开 Models（模型）页面。Eigent 预置了 Gemini、OpenAI、Anthropic、DeepSeek、Qwen 等一串供应商模板，你无需从零建配置。
2. 填字段：在 Gemini 卡片里填两处即可——
   • API Key：在 Google AI Studio 申请的密钥；
   • API Host：保留默认值https://generativelanguage.googleapis.com/v1beta/openai/（源码里预置的默认地址就写在这里：src/lib/llm.ts），走代理时才需要改；
   • 模型名：选一个可用的 Gemini 型号填进 Model Type。
3. 保存并验证：点保存后系统会实际请求一次接口做连通性校验，成功卡片会变成"可用"状态；再把它设为默认（Set as Default），之后所有智能体优先用这个模型。校验失败多半是 Key 抄错或网络出不去，回到上面 FAQ 对照排查。

进阶定制：改哪里

想往深处调，只认准这几个位置：

• 智能体定义在 backend/app/agent/factory/：browser.py、terminal相关、developer.py、document.py、social_media.py各对应一类智能体，改提示词和工具装配就在这里动；
• 工具集实现集中在backend/app/agent/toolkit/；
• 后端依赖统一用 uv 管理，拉了新代码后在backend/目录执行uv sync同步；
• 本地部署的后端服务、端口和数据卷说明都在 server/README_EN.md。

常见问题：模型连接失败等报错怎么排查

症状：npm run dev启动即报 Node 引擎错误 →原因：Node 版本不在 18–22 支持区间 →解决：node -v确认版本，换用 18 或 20 的 LTS 再试。

症状：发消息时提示模型连接失败 →原因：API Key 无效、额度用尽，或本机网络访问不了模型服务商 →解决：重抄一遍 Key 核对格式，换网络或配置代理；也可以先接 Ollama 等本地模型验证链路。

症状：界面能打开但接口 404 / 转圈 →原因：走本地部署时，server/下的后端服务没启动 →解决：确认 3001 端口的 FastAPI 服务在跑（浏览器访问http://localhost:3001/docs能看到 Swagger 页面即正常），详见 server/README_EN.md。

症状：npm install极慢或下载中断 →原因：默认 npm 源在国内网络下不稳定 →解决：临时切换 npm 镜像源后重新安装即可。

症状：启动时报端口被占用 →原因：上一次的开发进程没退干净 →解决：结束残留的 node/vite 进程后重启，或等旧进程完全退出再npm run dev。

到这里，你已经装好了一个本地可用的 Eigent 多智能体工作台，并接上了第一个模型。下一步建议：给一个真实任务试试 Workforce 模式，让多个智能体并行处理一件事，你会直观感受到它和单轮聊天的差别。

【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent