★ FEATURED ARTICLE Ekko Studio 本地多 Agent 工作区5 分钟跑起来聊天、编码、工作流一站搞定【免费下载链接】ekko-studioEkko Studio is a local-first AI workspace for multi-agent chat, coding, and visual workflows, available on desktop and the web.项目地址: https://gitcode.com/gh_mirrors/he/ekko-studioEkko Studio 是一个本地优先local-first的 AI 工作区多 Agent 聊天、编码助手和可视化工作流跑在同一台机器上适合想在本地统一管理各类 Agent 的开发者免去把对话、代码和自动化分散在多个工具里。先做决策选哪种使用形态Ekko Studio 有四种落地方式选哪种取决于你的环境形态适合谁一句话建议桌面应用个人电脑用户开箱即用内置 Hermes 运行时不用配环境npm 安装已有 Node.js 23 的机器两条命令起服务最轻量Docker Compose服务器 / 群晖 / 自托管单容器内置运行时数据落在本地目录源码开发想改代码的贡献者npm install npm run dev前后端同时起桌面应用装好后会自动安装受管命令ekko-studio打开应用、ekko-studio cli跑内置 Hermes Agent CLI、ekko-studio web跑服务端 CLI命令互不打架。快速开始npm 两条命令起服务 推荐先走 npm 路线最省事。要求 Node.js 23 及以上npm install -g ekko-studio ekko-studio-web start启动后打开http://localhost:8648。默认账号admin密码123456。登录进去后左侧能看到会话列表、页面打开新建聊天卡片、Agent 列表非空就说明跑通了。不想自动弹浏览器就加--no-open日常用ekko-studio-web stop停服务、status查状态即可。Docker 部署一条命令WEBUI_IMAGEekkoye8888/hermes-web-ui docker compose up -d访问 http://localhost:6060。Hermes 数据落在./hermes_data认证 Token 首次启动会打印在容器日志里详细排错看 docs/docker.md。你能用它做什么在同一个界面和不同 Agent 对话想做什么把 Hermes、Ekko、Claude Code、Codex 等 14 种 Coding Agent 放进一个界面管理。在哪里做Agent 管理器负责安装和更新 CLI新建聊天时从 Agent 卡片里选运行时和模型。预期结果回复以流式边生成边显示方式推送工具调用轨迹可展开查看Agent 生成的 HTML、PDF、Office 文档都能直接在线预览。让 AI 改代码并看到差异想做什么给某个编码任务一个工作区盯着 AI 改了哪些文件。在哪里做Coding Agent 页面内置终端可绑定工作目录和模型支持图片输入。预期结果会话历史自动保存改动以文件 Diff变更对比形式展示推理reasoning元数据一并持久化。把重复流程画成可视化工作流想做什么把研究 → 编码 → 人工审核这类多步任务编排起来而不是每次手动复制提示词。在哪里做工作流画布基于 Vue Flow拖入 Agent 节点连线设置条件、成功/失败路由和审批门。预期结果支持运行预算、截止时间和重跑执行历史持久化可以在画布上回放冻结的运行快照。给 Agent 排定时任务接上聊天平台想做什么让 Agent 按固定时间干活或把机器人接到 Telegram、Discord 上。在哪里做定时任务页管理 Cron计划任务表达式支持暂停、恢复和立即触发平台渠道页在同一个界面配置 10 个平台。预期结果凭证写入 Hermes Profile 的.env行为设置写入config.yaml每个平台显示已配置/未配置状态。看懂内部数据存哪、模块怎么分工先说结论Studio 平台和 Agent 运行时是两层数据互不侵占。前端浏览器 / Desktop / App通过 HTTP Socket.IO 连到 Koa 服务服务端再分四块业务——Studio 平台管单聊、群聊、工作流、文件、语音这些跨 Agent 的公共能力Hermes 模块管 Profile、模型、技能、记忆Ekko 模块管 Ekko 运行时Coding 模块管各编码代理的适配。这套边界在 packages/server/src/modules/ 里一一对应跨 Agent 的功能只准放 Studio防止某个 Agent 模块越界。对你最实际的影响是两份数据各管各的Studio 状态登录、日志、会话库、上传默认在~/.hermes-web-uiHermes Agent 的数据在~/.hermes。备份时两个目录都要带走会话存在本地 SQLite不依赖任何外部数据库。模块边界约束的完整规则见 docs/harness/server-module-boundaries.md。6 个最常用的环境变量变量默认值作用PORT8648服务监听端口端口冲突时改这里BIND_HOST0.0.0.0绑定地址只允许本机访问可改127.0.0.1HERMES_WEB_UI_HOME~/.hermes-web-uiStudio 数据目录Token、日志、数据库、上传HERMES_HOME~/.hermesHermes Agent 数据目录AUTH_TOKEN自动生成显式指定 Bearer Token不设置则首次运行自动生成LOG_LEVELinfo服务端日志级别WORKSPACE_BASE当前用户 Home文件浏览的根目录HERMES_LAN_ADVERTISE_URL未设置手机 App 局域网二维码使用的可访问地址完整清单约 50 个变量含 Agent Bridge 超时、Gateway 自动启动等高级项见官方文档 README_zh.md 的环境变量一节。故障排查先查这 4 处打不开登录页或提示未登录默认账号是admin/123456登录后会提醒你尽快修改Docker 场景下 Token 打印在容器日志docker compose logs hermes-webui里。提示端口占用换个端口启动例如ekko-studio-web start 8649或设PORT环境变量后重启。登录后被锁 / 无法再次登录运行ekko-studio-web clear-login-locks --restart清掉持久化的登录锁并重启服务。改了环境变量没生效配置大多在进程启动时读取改完执行ekko-studio-web restart注意 restart 会默认关闭 Agent BridgePython 桥接进程一般这是期望行为。Hermes 聊天能力不可用检查本机是否装了 Hermes 运行时源码目录或hermes命令均可运行时发现逻辑优先找含run_agent.py的目录再看hermes命令的 Python 环境最后回退系统 Python。收尾技术栈方面前端是 Vue 3 TypeScript Vite Naive UI Pinia后端是 Koa 2 Socket.IO SQLite源码分别位于 packages/client/src/ 和 packages/server/src/。项目采用 BSL-1.1 许可证覆盖 npm 包、CLI、桌面应用和文档。想继续深入建议按顺序读 DEVELOPMENT.md、ARCHITECTURE.md以及 DSH 接入说明 docs/dsh-management.md 和语音交互边界说明 docs/voice-dialogue.md。【免费下载链接】ekko-studioEkko Studio is a local-first AI workspace for multi-agent chat, coding, and visual workflows, available on desktop and the web.项目地址: https://gitcode.com/gh_mirrors/he/ekko-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
