Eigent 安装与配置 10 分钟上手多智能体工作流桌面应用新手实操指南【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigentEigent 是一个开源的 Cowork协作办公桌面应用让多个 AI Agent智能体在你本机并行处理文件整理、报告生成、CI 故障排查这类重复性桌面工作。适合想零代码自动化日常任务、又要求数据留在本地的开发者和个人用户。Eigent 到底是什么先对齐预期Eigent 本质上是一个装在你电脑上的AI 员工调度台。你给它派一个任务它安排一个或多个智能体去执行浏览器类智能体负责打开网页、抓取和填表终端类智能体负责跑命令、读写本地文件文档类智能体负责汇总产出。复杂任务可以拆给多个智能体并行干简单任务则交给单个智能体直接完成。它基于 CAMEL-AI 开源框架构建前端是 Electron React 桌面应用后端是 FastAPI 服务支持接入你自己的模型云端 API、Ollama 本地推理都可以也支持 MCPModel Context Protocol一种让 AI 调用外部工具的协议扩展能力。适合用来做不太适合用来做整理本机文件、批量处理文档替代专业 IDE 做深度编程定时抓取网页并汇总成报告需要 7x24 小时稳定在线的生产服务除非你自托管后端用本地模型跑私密数据任务一次性、几秒就能手动搞定的小操作多步骤工作流取数 → 分析 → 产出报告完全离线场景首次安装仍需拉取依赖如何从零安装并启动 Eigent先检查环境要求依赖项最低要求推荐配置Node.js18.xengines 限制在 18~22 之间20.x LTS带 npmPython云模式可不装本地自托管需 3.11/3.123.12.xDocker仅本地自托管后端需要Docker Desktop 已安装并运行端口3001API、5432PostgreSQL未被其他服务占用最容易踩的坑如果你本机已经装过 PostgreSQL 或 Redis5432、6379 端口大概率被占用docker compose up会直接起不来先停掉旧服务或改映射端口。最快体验路径云模式 4 条命令前提是 Node.js 版本在 18~22 之间。在项目目录执行git clone https://gitcode.com/GitHub_Trending/ei/eigent cd eigent npm install npm run dev执行npm run dev后Vite 会启动开发服务器并拉起 Electron 窗口首次打开需要注册账号此模式会连接官方云服务。窗口里能看到工作区、模型设置和会话列表整个安装到界面可用通常几分钟内完成。完整本地部署用 Docker 把后端跑在自己机器上数据隐私敏感的场景下建议把后端也放到本地。server/目录里是一套 Docker Compose 编排PostgreSQL Redis FastAPI API Celery 定时任务在server/目录下执行cd server cp .env.example .env docker compose up --build -d首次构建要编译镜像并执行数据库迁移耐心等待直到docker ps里各容器状态变成 healthy。容器启动时 Alembic 会自动跑数据库迁移数据落在 Docker 卷server_postgres_data里。接着让前端连到本地后端在项目根目录的.env.development里写入下面三行再重新npm run devVITE_BASE_URL/api VITE_USE_LOCAL_PROXYtrue VITE_PROXY_URLhttp://localhost:3001验证是否连通浏览器打开http://localhost:3001/docs能看到 Swagger API 文档页说明后端正常。详细步骤见 本地部署指南。怎么给 Eigent 配置模型模型配置只取决于一个关键问题你的数据能不能出本机可以出本机 → 直接配云端 APIOpenAI、Google Gemini、Anthropic 等填 API Key 就能用最省事。必须留在本地 → 先跑一个本地推理服务Ollama、LM Studio 或 vLLM把 Eigent 指向它的本地地址Eigent 本身不内置模型只做调度。以添加一个云端模型为例分步演示打开应用顶部导航的Settings设置进入Models模型页面。选择你的服务商例如 OpenAI 或 Google Gemini填入API Key如果你用的是中转服务或企业网关把API Host改成对应地址。填入模型名称即模型 ID如gpt-4o保存。保存后该模型卡片会出现在列表里点击设为默认新会话就会用它。回到工作区发起一句你好能正常回复就说明链路通了。本地模型同理先把 Ollama 拉起来ollama pull你选的模型然后在同一页面填入本地地址Ollama 默认http://localhost:11434和模型名。Eigent 能解决哪些真实任务整理杂乱的桌面。直接在会话里说一句看看我桌面上的文件按用途归类整理智能体会先列出看到的文件再逐个移动到新建的文件夹里。整个过程发生在你自己的机器上你可以在侧边看到它的每一步操作做错了还能立刻叫停。每月开发报告自动化。官方用例里用户用 Ollama 跑本地模型让 Eigent 回顾一个月的 Git 拉取请求自动生成一份 Word 摘要并顺手写好对应的 Slack 发布公告。配合触发器Triggers功能把流程设成定时执行每月这一天就不用再手动汇总了。排查 CI 流水线为什么挂了。这是个典型的多智能体协作场景一个智能体负责取回构建日志一个负责和基准值对比另一个做深度推理最后汇总成一份结构化的审计报告。你不需要自己打开十几页日志直接看结论和证据链。工单数据可视化。把本地工单 CSV 交给它它会导入数据、生成带图表的统计报告适合运营周报、客服月报这类数据都在手边、就是懒得做图的活。Eigent 遇到问题怎么解决报错/现象原因解决办法npm run dev提示 engine 不兼容或启动异常Node 版本超出 18~22 范围用 nvm 切到 18~22 的 LTS 版本再重装依赖拉取新代码后前端报错、缺依赖前端和后端依赖各自独立管理根目录跑npm install再进backend目录跑uv syncdocker compose up卡在端口占用本机已有 PostgreSQL/Redis 占着 5432/6379停掉旧服务或改docker-compose.yml里的宿主端口映射Docker 拉镜像特别慢或超时网络原因在 Docker Desktop 里配置镜像加速后重试官方文档有提示本地模型在设置里连不上Ollama / LM Studio 没在运行或地址写错先确认推理服务已启动地址填本机端口再点保存验证前端一直连不上本地后端没配置本地代理检查.env.development三行配置并确认 3001 端口的 API 容器是 healthy接下来做什么入门与功能总览中文 README本地后端部署细节含开发模式热重载本地部署指南想参与开发贡献指南后端代码结构backend/建议的下一步先把你已有 API Key 的模型设为默认然后开一个新会话从整理桌面文件这个最小任务开始——它不涉及外部服务、几轮就能看到结果最适合验证整条链路是否跑通。【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考