
Eigent 安装配置与快速上手从零到跑通第一个智能体任务【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigentEigent 是一个跑在你自己电脑上的多智能体工作台它把让 AI 帮你干活这件事装进一个桌面应用里你可以让单个智能体写代码、整理文件、操作浏览器和终端也可以把多个智能体串成一条自动流水线并行处理复杂任务。全文按能不能装 → 最快装起来 → 配到能跑 → 确认跑通 → 干一件真事 → 卡住怎么办 → 想深挖的顺序走读完你能自己把 Eigent 跑起来并完成第一个让智能体真正产出结果的操作。动手前先过这张清单以下任一项不满足后面会装不上或跑不动先核对再往下走操作系统Windows 10/1164 位、macOS 10.14、或 Ubuntu 18.04Node.js版本必须在 18 到 22 之间node -v看一眼低于 18 或到 23 会报错Python3.11 或 3.12后端用装依赖时才会真正用到内存 / 磁盘至少 8GB 内存、10GB 空闲空间网络能正常访问 npm 镜像和你要用的模型服务云模型需要外网自检点node -v打印出v18/v20/v22之一且磁盘剩余空间够就继续。克隆后敲的第一条命令最快的路线是先连上云端的快速开始模式三步就能起来。打开终端在你想放代码的目录执行git clone https://gitcode.com/GitHub_Trending/ei/eigent cd eigent npm install npm run devnpm install会装全部前端和 Electron 依赖npm run dev起本地开发服务器并拉起应用。自检点终端打印出本地地址127.0.0.1:7777一类并弹出一个 Eigent 应用窗口。窗口能打开、不是白屏就说明装起来了。这条路线走的是云后端登录时需要注册账号。想完全本地、数据不出机器的走 server/README_EN.md 里的 Docker 方案装好 Docker Desktop 后在server/目录拷一份.env.example成.env再docker-compose up --build -d最后在项目根目录建.env.development把后端指到http://localhost:3001再npm install npm run dev。想自己编译打包桌面安装程序的话对应的是npm run build。把 API Key 填进去窗口起来后最关键的配置只有一件事告诉 Eigent 用哪个模型、密钥放哪。按配什么 → 去哪拿 → 填到哪 → 保存走一遍。配什么一组模型提供方Provider的 API Key、服务端点Host、以及要用的 Model Type。去哪拿用云模型就到对应官方控制台申请——Gemini 在 Google AI Studio、OpenAI 在它的平台控制台如果你用本地推理Ollama、LM Studio、vLLM本地跑不需要 Key只填端点。填到哪进入设置页打开Models选项卡。选到对应模型后展开自定义配置把 API Key 填进密钥那一栏Host 用默认或改成你的端点Model Type 选具体版本。保存填完点Save。这一步不能省否则配置不生效。想固定用某一个模型就在它的卡片上把它设为默认右上角出现绿色Default标签代表系统默认走它。自检点Save 后页面不再报红且你选中的那项带上了 Default 标签。用一个最小请求确认跑通别急着看功能先确认模型真的接通了。回到对话区发一句最简单的话比如用一句话介绍你自己。自检点智能体正常吐出一段回复而不是报错、转圈或空白。能回话 模型配置通了前面几步都对了。干一件真事让智能体跑一个脚本现在让它做一件有产出的小事体会它真的在干活。切到Single Agent单智能体模式输入一条明确指令在工作区里新建一个greet.py内容打印Hello Eigent然后运行它。接下来观察它调用内置终端工具包先创建文件、再执行脚本。自检点终端里出现Hello Eigent的输出且工作区里能看到greet.py文件。看到这两样说明从指令到工具执行到落盘整条链路都通了。卡住了看这里npm run dev报 Node 版本不满足→ 大概率 Node 不在 18-22 范围 → 用版本管理器切到 18/20/22 再重跑。后端uv run卡住不动→ 多半是锁文件残留 → 删掉uv_installing.lock/uv_installed.lock重试或直接改用.venv/bin/python main.py详见 backend/README.md。模型配了但对话没反应或报错→ Key 填错或没保存 → 回 Models 重新核对并点 Save确认出现 Default 标签。界面一直白屏或转圈→ 端口被占或前端没真正起来 → 关掉重复进程重跑npm run dev。本地模型如 Ollama连不上→ 端点没带/v1或本地服务没启动 → 确认 Ollama 在运行端点填http://localhost:11434/v1。想更进一步环境变量后端一堆EIGENT_*变量端口、工作区、调试开关、工具能力范围可在独立运行时覆盖清单在 backend/README.md。本地数据与数据库走 Docker 方案时用户、模型配置、聊天记录都存在本机 PostgreSQL 卷里容器启动时自动迁移相关说明在 server/README_EN.md。下一步去 Models 里再多接一个模型、或把两个智能体排进一条流水线试试——从能跑到顺手就差这一步。【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考