Eigent 四步跑通本地多智能体协作零云依赖【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent当你把代码交给云端的 AI 智能体数据流经云端账号、模型选择被限定在几个、订阅费用持续累加——想把它搬回本地的念头就冒出来了。Eigent 是开源的多智能体协作桌面主打本地部署克隆仓库、拉起本地后端一个带浏览器、终端和文档工具的 agent 团队就装在你机器上不注册云账号。 9 行命令把 Cowork 桌面跑起来这一段做的事克隆仓库、用 docker-compose 拉起本地后端PostgreSQL Redis FastAPI 共五个容器、写前端代理配置、启动 dev 模式。后端全部由 server/docker-compose.yml 定义数据落在本地卷里。git clone https://gitcode.com/GitHub_Trending/ei/eigent cd eigent/server cp .env.example .env docker-compose up --build -d cd .. echo VITE_BASE_URL/api .env.development echo VITE_USE_LOCAL_PROXYtrue .env.development echo VITE_PROXY_URLhttp://localhost:3001 .env.development npm install npm run dev跑通后 Vite 的 electron 插件会直接弹出桌面窗口浏览器打开http://localhost:3001/docs能看到 Swagger 页面——看到这个页面说明本地后端活着之后的聊天记录、模型配置、工具设置全部只进你机器上的 PostgreSQL。三个实操旋钮接自己的模型、看清分工、插 MCP模型不锁死把 Ollama 指给 agent现象想让日常任务走本地模型却发现设置里默认都是云端 provider。说白了模型层是可插拔的provider 本质就是一份base URL key配置。先确认本地模型服务通curl -s http://localhost:11434/v1/models能返回模型列表再去桌面端设置页把 Ollama 注册为 Provider填http://localhost:11434/v1。本地、云端可以混用类型代表 provider适合场景本地部署Ollama、vLLM、LM Studio、SGLang敏感数据、离线环境云端 APIOpenAI、Anthropic、DeepSeek、Moonshot复杂推理、偶发重任务8 个 agent 角色内部分工一张表看清现象把大任务丢给单个 agent它容易顾此失彼。原理一句话——不同角色配不同 system prompt 和工具集workforce 模式按角色拆任务并行执行。实现都在 backend/app/agent/factory/ 目录一个文件一个角色工厂文件角色browser.py高级研究分析师联网检索developer.py主力软件工程师document.py文档专家multi_modal.py创意内容专家social_media.py社交媒体运营mcp.pyMCP Server Agent建任务时你可以选单 agent一个主 agent 跑完整个链路或 workforce拆分并行这也是宣传语里multi-agent的实际落点。MCP把任意工具挂到 agent 身上现象agent 会浏览网页、会敲终端但你的内部系统它摸不到。原理MCPModel Context Protocol把工具标准化成服务Eigent 支持本地/远端 MCP 两种导入。先验证后端服务本身健康curl -s http://localhost:3001/health然后打开http://localhost:3001/docs登录拿到本地签发的 token 点 Authorize调用POST /mcp/import/Local这类接口导入服务前端 MCP 列表出现之后agent 就能在任务里直接调它的工具。进阶实战秒级热重载与外网 trigger 回调两个真实场景开发这个项目的后端调试以及接收 webhook 的 trigger 功能。场景朴素写法优化写法为什么这么配改后端代码docker compose restart停 API 容器uvicorn --reload直连省掉镜像重建秒级热重载改表结构手动 psql 改表alembic upgrade head迁移可复现多环境不漂移trigger 回调直接填127.0.0.1:3001ngrok http 3001换公网 URL外部服务只能访问公网 HTTPS热重载模式的完整写法见 server/README_EN.mddocker stop eigent_api cd server uv run alembic upgrade head export database_urlpostgresql://postgres:123456localhost:5432/eigent uv run uvicorn main:api --reload --port 3001 --host 0.0.0.0五步把容器换成本地 uvicorn 进程保存文件即生效每轮迭代省掉两三分钟镜像重建。而 trigger 要收 webhook 必须公网可达本地开发用一条命令ngrok http 3001把生成的 https 地址填进 trigger 回调配置外部服务的回调就能打到你本机。 你可能踩过的坑现象uv run首次启动卡死、没输出。根因上次安装中断uv 残留了锁文件。修复rm -f uv_installing.lock uv_installed.lock这个坑我替你踩过了急的时候也可以直接用.venv/bin/python main.py绕开 uv 启动。现象VITE_USE_LOCAL_PROXY设了 true请求还是打到云端登录 404。根因Vite 依赖缓存没清环境变量没生效。修复npm run clean-cache npm run dev现象git pull之后页面报错、后端 500。根因前端和 Python 依赖没同步更新。修复npm install cd backend uv sync现象brain 服务起不来端口 5001 被占用。根因默认端口冲突。修复改端口环境变量完整列表见 backend/README.mdexport EIGENT_BRAIN_PORT5002性能上的量化参照首次docker-compose up --build视网络要三到十分钟镜像构建完成后之后每次docker compose start通常在半分钟内恢复可用调试期不用再碰构建。那个原来锁在云端的桌面现在跑在你本地机器上了。接下来三件事把热重载模式试一遍接上 Ollama 跑完一个小任务翻一遍 factory 目录那 8 个文件看看分工是怎么落地的。【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考