Eigent 安装配置指南10 分钟跑通本地多智能体桌面应用【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent想让一批 AI 智能体在本地并行干活又不想数据经过云端Eigent 是一个开源的 cowork 桌面应用支持单智能体与多智能体协作可对接任意模型。本文带你走通「云端快速预览」和「完全本地部署」两条启动路径并说明首跑如何完成模型配置。适合想从源码跑起项目、或在本地私有环境使用的开发者。功能范围装好之后你能做什么这一节先说清 Eigent 的边界方便你判断它是否符合你的使用场景。单智能体工作区用一个聚焦的元智能体陪你完成调研、写作、调试等直接任务。多智能体 workforce多个专业智能体分工、并行执行多步骤工作流例如「取日志 → 对比数据 → 生成审计报告」。内置浏览器与终端工具包智能体可以真实操作本机网页和命令行而不只是对话。模型无关云端 APIOpenAI、Gemini 等、企业网关或本地推理Ollama、vLLM、LM Studio都可以接入不锁定厂商。本地数据部署本地后端后账号、聊天记录、模型配置全部存在自己机器上可选完全离线使用。运行前检查Node、Docker 等依赖清单开始之前先对照下面这张表区分两种启动模式的硬性依赖避免装到一半才缺件。依赖项要求适用范围Git任意近期版本必须获取源码Node.js18–2218.0.0 23.0.0必须前端/桌面端npm随 Node.js 自带必须Docker Desktop Compose已安装并可运行本地部署模式必须云端预览模式不需要Pythonbackend 需 3.11server 需 3.12仅单独开发后端时关心正常路径由uv自动管理模型服务云端 API Key 或本地推理服务必须首次运行配置内存 / 磁盘8GB / 10GB 可用建议公网可达的 HTTPS 域名—仅在使用 trigger 入站 webhook 时需要可选跑起来的最短路径两条启动路线Eigent 提供两种启动方式先用云端后端快速预览界面或直接用 Docker 起本地后端实现完全隔离。每条命令后附一句说明照抄即可。云端连接预览三条命令打开桌面窗口这条路线最快看到界面但需要注册 Eigent 云账号。git clone https://gitcode.com/GitHub_Trending/ei/eigent cd eigent克隆源码并进入项目根目录确认能看到package.json和backend目录。npm install安装前端与桌面端依赖成功后生成node_modules目录且没有 engine 版本报错。npm run dev清理缓存后启动 Vite 开发服务器并拉起 Electron 窗口浏览器应打开默认地址http://127.0.0.1:7777/看到登录页面即代表前端已运行。本地部署Docker 一条命令起后端和数据库这条路线数据完全留在本机是官方推荐的生产用法完整说明见 server/README_EN.md。cd server cp .env.example .env docker-compose up --build -d构建并后台启动 API 与 PostgreSQL 两个容器容器启动时 Alembic 会自动执行数据库迁移执行完用docker ps应看到两个 Up 状态的容器。然后在项目根目录创建.env.development把前端指向本地后端VITE_BASE_URL/api VITE_USE_LOCAL_PROXYtrue VITE_PROXY_URLhttp://localhost:3001保存后再执行npm install和npm run dev此时界面发出的/api请求会全部打到本机 3001 端口的后端。验证是否安装成功四个判断标准安装是否成功不取决于命令有没有报错而取决于下面四个可操作的标准是否全部满足。后端健康浏览器打开http://localhost:3001/docs能看到 Swagger UI 接口文档说明本地 API 已就绪本地部署模式。容器状态docker ps中eigent_api与eigent_postgres均为 Updocker logs -f eigent_api无持续报错。前端连通打开开发窗口后能完成登录本地模式可直接用邮箱密码在本地后端注册进入工作区页面。模型可用完成下文模型配置后发起一条测试对话智能体能返回正常响应而非 401/超时错误。四条全部满足即可认为安装配置完成。首跑必做配置接入模型与创建账号桌面端能跑起来只是起点真正让智能体工作还差两项必做配置一个可用的模型接入、一个登录账号。接入模型决定智能体能不能干活在设置页的 Models 入口添加模型按你选的接入方式填写字段从哪里获取怎么填API Key对应模型服务商的官方控制台原样粘贴注意不要混入空格Host / 端点服务商文档云服务用默认地址本地推理填本机地址如 Ollama 的http://localhost:11434模型名称服务商模型列表或本地服务ollama list填具体模型版本不要留空填完务必点击保存并把你最常用的一个设为默认模型界面出现 Default 标识。本地部署模式下同样的配置也可以通过本地后端的/provider相关接口写入存进本地 PostgreSQL。如果你只用 Ollama 等本地模型全程不需要任何云端 Key也无需联网到第三方服务。创建登录账号本地部署模式在设置完成后可直接在本地后端注册邮箱密码账号登录状态与令牌全部保存在本机云端预览模式则需要在 Eigent 云注册。两种方式都完成后回到工作区发起第一条对话验证链路。避坑指南五个常见报错的症状与解决以下问题按「症状 → 原因 → 解决办法」整理均来自仓库文档中明确的限制与已知行为。1.npm install报 engine 不兼容EBADENGINE原因[package.json](https://link.gitcode.com/i/19dce3f16500e597f011f2616a9dd2d1)中engines严格限定 Node 为18.0.0 23.0.0你当前 Node 版本越界。 解决用 nvm 等版本管理器切到 18–22 后重新安装不要强行--force忽略后续构建可能继续失败。2. 启动 backend 时uv run卡住无输出原因上一次安装遗留的uv_installing.lock/uv_installed.lock锁文件。 解决删除这两个锁文件后重试或绕过 uv 直接用.venv/bin/uvicorn main:api --port 5001处理方式见 backend/README.md。3. 前端页面请求 404 或连不上本地后端原因根目录没有创建.env.development或VITE_USE_LOCAL_PROXY未设为true请求仍发往云端。 解决按上文三行内容补全该文件然后重启npm run dev环境变量只在启动时读取。4. 容器起不来日志提示 3001 或 5432 端口被占用原因本机已装 PostgreSQL 常占用 5432其他本地服务可能占用 3001。 解决停掉冲突服务或修改 server/docker-compose.yml 中的宿主机端口映射并同步更新.env.development里的VITE_PROXY_URL。5. trigger 的 webhook 收不到外部回调原因入站 trigger 要求外部服务能通过公网 HTTPS 回调你的服务器纯本地地址天然不可达。 解决本地开发用 ngrok 等工具临时暴露服务正式使用则部署到带域名和 SSL 证书的环境详见 server/README_EN.md 的 Hosting Configuration 一节。深入学习文档与关键源码路径跑通之后想改配置或看实现优先看这三处server/README_EN.md本地后端完整文档包含开发者模式uv run uvicorn热重载 alembic upgrade head手动迁移、数据持久化卷、i18n 编译命令。backend/README.md智能体执行引擎Brain的独立启动方式与环境变量表如EIGENT_BRAIN_PORT、EIGENT_HANDS_MODE、EIGENT_DEPLOYMENT_TYPE控制端口的和工具能力边界都在这里。目录速查backend/app/agent/ 是智能体与工具包实现backend/app/hands/ 是本地/远程执行能力server/app/domains/ 是本地后端的用户、模型、MCP、trigger 等领域模块。接下来可以拿 Eigent 做什么配置完成后建议按这个顺序验证完整能力先用单智能体会话处理一件真实的小事比如整理一个混乱的目录再把同一任务交给两个以上智能体组成的 workforce 对比并行执行效果确认稳定后接入一个 MCP 服务扩展工具能力或配置一个定时 trigger 让它周期性执行报告类任务。【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
