
5 分钟上手 MindsHubWeb、桌面应用与源码构建三种快速开始方式【免费下载链接】mindshubThe unified workspace where open-source models get things done for you.项目地址: https://gitcode.com/GitHub_Trending/mi/mindshubMindsHub 是一个让开源 AI 模型真正帮你干活的统一工作区Unified Workspace接入你的数据源自由切换 Claude、GPT、Gemini、DeepSeek、Qwen 等模型用开源智能体Anton、Hermes自动完成报告、监控、定时任务并把产出发布为可分享的 Web 应用。本文带你用 5 分钟走完 MindsHub 快速上手的三种路径Web 网页版、桌面应用安装、源码构建新手照抄命令即可跑通。三种快速开始方式先选你的路线 方式适合人群需要安装上手时间Web 网页版所有新手零安装浏览器打开即用1 分钟桌面应用macOS / Windows 用户下载.pkg/.exe安装包3 分钟源码构建开发者、Linux 用户、想部署到 VPC/内网Node.js Python 3.10–3.135 分钟起 项目采用 MIT 协议开源可免费开始使用Pro 版解锁全部前沿模型与私有制品。方式一Web 网页版零安装体验 MindsHub最快的方式是直接使用托管 Web 应用在浏览器中打开 MindsHub 控制台注册/登录账号即可进入工作区连接数据源BigQuery、Postgres、Gmail、Notion 等凭据按连接隔离智能体看不到原始密钥在Model Router中自由切换开源模型与商业模型无需逐个配置 API Key把智能体产出转成文档、仪表盘、应用等Artifacts一键发布到可访问的 URL 与团队共享。Web 版不需要任何本地环境最适合先体验核心功能、再决定要不要本地部署的用户。方式二桌面应用安装macOS 与 Windows 一键上手 ️桌面应用基于 Electron 打包内置cowork-server运行时下载即装macOS下载.pkg安装包双击安装后直接启动Windows下载.exe安装包按向导完成安装Linux暂不提供官方安装包请使用下文「源码构建」方式。首次启动会进入引导页支持 BYOK自带 API Key模式填入你的模型密钥即可开工。本地数据库、项目与会话状态统一存放在~/.cowork模型密钥存放在~/.anton迁移机器时备份这两个目录即可。方式三源码构建完整掌控 MindsHub 全栈MindsHub 仓库是一个「超级项目」superproject把前端、API 后端、智能体、数据引擎四个子模块固定到指定版本前端应用frontend/API 后端cowork-serverbackend/core_api/智能体Anton/Hermesbackend/core_agent/数据引擎backend/data-vault/第一步一键克隆仓库含全部子模块git clone --recurse-submodules https://gitcode.com/GitHub_Trending/mi/mindshub cd mindshub如果漏了--recurse-submodules可补执行git submodule update --init --recursive完成初始化。第二步安装依赖make setup这一条命令会自动完成npm ci安装前端依赖 uv sync为 backend/core_api/ 和 backend/core_agent/ 创建 Python 虚拟环境要求 Python 3.10–3.13。第三步运行桌面热重载或浏览器双模式需求命令桌面应用Electron 热重载make dev或make watch浏览器 Web 应用 热重载make dev-web生产环境构建make build打包 macOS 安装包make dist-mac打包 Windows 安装包make dist-winmake dev会同时启动 Python 后端uvicorn --reload与 Electron 前端改代码即时生效make dev-web启动后打开http://localhost:5173/FastAPI 后端自动运行在http://127.0.0.1:26866。⚠️本地 Web 模式跳过登录浏览器模式默认会跳转 SSO 登录。本地开发时创建frontend/src/renderer/.env并写入VITE_SKIP_AUTHtrue重启后直接进入引导页详见 CLAUDE.md 的「Running locally」章节。常用 Makefile 命令速查 完整目标列表见 Makefile输入make help可打印说明命令作用make setup安装全部模块依赖make dev/make dev-web本地源码热重载运行桌面 / Webmake refs查看当前各子模块将使用的分支make use按 dev.env 切换全部子模块分支make baseline把子模块重置回超级项目固定的基线提交make flush一键清空本地安装与应用状态恢复出厂环境坏了怎么办make flush会移除cowork-server运行时、各子模块.venv以及~/.anton密钥、~/.cowork数据库、项目——相当于格式化重装之后重新make setup即可。注意它会删除会话记录执行前会要求确认FORCE1跳过。用 Docker 快速起一套 Web 栈不想装 Node/Python 环境仓库内置 docker-compose.yml两个容器一步到位docker compose build docker compose upapi容器构建自 docker/api.Dockerfile暴露26866端口数据持久化到cowork-data卷web容器构建自 docker/web.Dockerfile3000端口对外提供服务Nginx 将/v1/请求反向代理到 API见 docker/nginx.conf。模块分支开发一个文件控制所有分支 仓库对每个子模块做了「提交固定」pin日常在子模块里开发分支不会污染父仓库的git status。想在自己的分支上开发时cp dev.env.example dev.env # 填入 REFfeat/my-thing 等 make use # 所有子模块切到你指定的分支 make dev # 基于本地分支热重载运行dev.env.example 支持统一分支REF也可按模块分别指定FRONTEND_REF/API_REF/AGENT_REF。完整的多开发者工作流见 CLAUDE.md。核心文件导航 文件说明README.md项目介绍与快速开始Makefile所有构建/运行命令的入口docker-compose.ymlDocker 部署编排dev.env.example模块分支选择模板docs/index.html官方文档首页docs/setup.html安装与搭建指南docs/api.htmlAPI 参考文档常见问题 FAQQ1没有商业模型 Key 能用吗可以。Model Router 支持 DeepSeek、Qwen、Kimi 等开源模型也支持 BYOK 自带任意提供商密钥。Q2会话数据存在哪里本地统一存于~/.coworkSQLite 数据库、项目、Hermes 状态模型密钥在~/.anton。Q3如何彻底重置环境运行make flush删除全部本地运行时与应用状态再用make setup全新安装。Q4Linux 用户能装吗可以走「源码构建」路线git clone --recurse-submodules→make setup→make dev-web浏览器里访问localhost:5173即可。选对路线5 分钟后你的 MindsHub 工作区就已经跑起来了——先从 Web 版体验再用源码构建拿回全部控制权 【免费下载链接】mindshubThe unified workspace where open-source models get things done for you.项目地址: https://gitcode.com/GitHub_Trending/mi/mindshub创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考