Eigent多智能体协作桌面安装配置指南：从克隆到跑通只需4步

Eigent多智能体协作桌面安装配置指南从克隆到跑通只需4步【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigentEigent是一个开源的多智能体协作Cowork桌面应用让多个AI智能体在你本机并行执行研究、写作、编码和定时自动化任务。本指南面向第一次接触它的开发者带你从克隆仓库走到桌面应用可用的状态。跑之前先核对这几样核对完下面的清单你的机器就能直接装前端和后端依赖。Eigent由 FastAPI 后端与 React Electron 前端组成依赖版本有硬性约束。环境项最低要求推荐值操作系统macOS、Windows 或 Linux64位macOS 或 Windows 11Node.js≥18 且 2322 LTSPython3.11.xagent后端或 3.12.x本地部署服务3.12Docker仅本地部署路径需要已安装并在运行网络可访问 npm、PyPI云连接模式需能连云后端稳定宽带最典型的两种不满足症状Node.js 不在 18-22 区间时npm install会直接报引擎版本错误Python 版本不匹配时后端的uv sync会装不上依赖。从克隆到跑通走完这一节你会得到一个自动打开的 Eigent 桌面窗口注册后即可向智能体下任务。项目有两条运行方式先看对照表本文只详细展开第一条。适用人群路径你会得到什么第一次体验想尽快跑起来云连接模式npm run dev桌面应用 云端后端需注册账号数据必须留在本机本地部署server/目录Docker 起 FastAPI PostgreSQL完全离线的后端步骤见 server/README_EN.md第1步克隆仓库并进入目录。git clone https://gitcode.com/GitHub_Trending/ei/eigent cd eigent第2步安装前端依赖。npm install[!WARNING] 这一步会拉取 Electron 等较大依赖耗时几分钟。如果日志里出现EBADENGINE先把 Node.js 切到 18-22 再重装。第3步启动开发服务器Electron 窗口会自动弹出。npm run dev这个模式连接 Eigent 云服务按首次引导注册账号后才能使用智能体想要数据完全留在本地就走对照表里的本地部署路径。第4步按需git pull更新代码后同步后端 Python 依赖。cd backend uv sync截图Eigent 工作区背景展示 Browser Agent、Terminal Agent 等内置智能体入口按你的用法微调做完这一节你会得到一套与你的运行模式匹配的默认行为改完即生效无需二次构建。以下配置项都来自仓库自带文件可直接照抄。场景改哪里改成什么前端指向本地后端根目录.env.developmentVITE_USE_LOCAL_PROXYtrue、VITE_PROXY_URLhttp://localhost:3001改智能体后端端口环境变量见 backend/README.mdEIGENT_BRAIN_PORT默认 5001、EIGENT_BRAIN_HOST改智能体工作目录环境变量EIGENT_WORKSPACE默认~/.eigent/workspace配置默认模型应用内 Settings →Models页云厂商 API Key或 Ollama、vLLM 等本地推理平台后端热重载调试环境变量EIGENT_DEBUG1分支规则如果你走的是云连接模式不要动.env.development仓库里它默认就指向云端只有本地部署时才需要把VITE_USE_LOCAL_PROXY改为true。本地部署时的前端配置如下# .env.development VITE_BASE_URL/api VITE_USE_LOCAL_PROXYtrue VITE_PROXY_URLhttp://localhost:3001改完保存后重启npm run dev前端/api请求就会代理到你本机的 FastAPI 服务。跑不动时查这张表这一节解决首次启动最常见的五类报错先对照现象定位再按右列处理绝大多数情况不用改源码。现象先查什么怎么处理npm install报EBADENGINEnode -v的输出把 Node.js 切到 18-22删掉node_modules重装窗口能开但接口报错、登录失败.env.development中VITE_PROXY_URL指向的后端是否在运行云连接模式确认网络能通云端本地部署先按 server/README_EN.md 起 docker composeuv sync卡住不动backend/下的uv_installing.lock锁文件删除锁文件重试或直接用.venv/bin/python main.py启动见 backend/README.md端口 5001 被占用lsof -i:5001看占用进程把EIGENT_BRAIN_PORT改成别的端口鉴权失败、token 报错云模式是否已注册账号本地部署.env是否照 server/.env.example 填了必填项重新注册登录本地部署补齐secret_key等必填值跑通之后你的下一个调优点通常在Models页把你已有的模型接进来再按任务挑智能体。更多部署细节和已知问题见仓库内 server/README_EN.md 与 CONTRIBUTING.md。【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考