README

MindsHub 是一个智能体工作空间，让你使用开源智能体执行框架和自选模型完成知识工作、开发软件。






官网 ·
文档 ·
网页应用 ·
定价 ·
Discord


  其他语言: English · Español · Português · हिन्दी





  


MindsHub 让你自由选择模型和服务提供方，无需受限于单一生态系统。你可以在其智能体工作空间中开展研究、分析、内容创作和软件开发。它是开源的，可以运行在你的电脑、VPC 中，也可以通过托管应用使用。

本仓库是平台超级项目(superproject):它整合了桌面/网页应用、智能体后端和数据引擎,让你可以从源码构建并运行整套技术栈。

如果你希望通过一个 API 为智能体和产品集成智能能力，请参阅 MindsHub Inference。它支持选择不同的模型和服务提供方，并通过同一套管理工具统一管理和计费。

 快速开始

选择最适合你的方式:

- 网页版 —— 无需安装。 打开 console.mindshub.ai 并登录。
- macOS。 下载桌面应用(.pkg)。
- Windows。 下载桌面应用(.exe)。
- Linux。 从源码构建。

免费即可开始使用。Pro 版本解锁全部前沿模型与私有成果物——详见定价。

 你能做什么

面向每一位知识工作者——创作者、策略制定者与运营者:

- 自动化涉及读写的重复性多步骤工作:报告、监控、周期性工作流以及定时运维任务。
- 构建内部 AI 工具与成果物——应用、仪表盘、演示文稿、文档、分析报告——无需工程开发,并发布到可分享给团队的在线链接。

 内含功能

- 数据连接。 安全的密钥库(vault)可连接 BigQuery、Postgres、Gmail、Drive、HubSpot、Notion、Linear 等系统。凭证按连接单独限定范围——智能体永远看不到原始密钥。
- 模型路由(Model Router)。 在前沿模型(Claude、GPT、Gemini)与开源模型(DeepSeek、Qwen、Kimi)之间自由切换,无需为每个提供方单独配置密钥。
- 开源智能体。 运行可互换的开源执行引擎(harness)——Anton(默认)与 Hermes——通过下拉菜单即可切换。
- 成果物(Artifacts)。 将智能体的产出转化为文档、仪表盘、应用与代码,并发布到在线链接。
- 记忆、技能与定时任务。 跨会话记忆、可复用的技能库,以及按计划运行的任务。

 从源码构建

1. 克隆仓库

bash
git clone --recurse-submodules https://github.com/mindsdb/minds.git
cd minds


2. 安装依赖

bash
make setup


3. 运行

| 模式 | 命令 |
|---|---|
| 桌面应用(Electron),支持热重载 | make dev 或 make watch |
| 浏览器网页应用,支持热重载 | make dev-web |
| 生产构建 | make build |
| 打包 macOS 版本 | make dist-mac |
| 打包 Windows 版本 | make dist-win |
| 从本地未提交的源码构建 macOS .app | make pack-local |
| 清除所有本地安装与数据(从零开始) | make flush |

 从零开始: make flush 会移除本地运行环境(cowork-server uv 工具及 backend//.venv),并删除 ~/.anton(提供方密钥)与 ~/.cowork(数据库、hermes、项目)中的应用状态。用它来测试从零安装流程,或从损坏的安装中恢复。执行前会要求确认——传入 FORCE=1 可跳过确认。之后运行 make setup 或启动应用即可重新安装全部内容。⚠️ 此操作会删除你的对话记录和已保存的密钥。

 在功能分支上开发(子模块)

本仓库是一个超级项目,将每个模块(frontend、backend/core_api、backend/core_agent、backend/data-vault)固定(pin)到某个提交。要在模块分支上开发而不污染 git status 或与固定版本产生冲突:

1. 在(已加入 .gitignore 的)dev.env 中选择你的分支(从模板复制):

bash
cp dev.env.example dev.env       然后设置 REF=feat/my-thing(或按模块设置 API_REF=…)


2. make 会自动读取该配置 —— 一个开关,适用于两种运行方式:

| 命令 | 作用 |
|---|---|
| make use | 按 dev.env 中的配置检出所有子模块的分支 |
| make dev / make watch | 以本地源码热重载方式运行 Electron 应用 |
| make dev-web | 以本地源码热重载方式运行网页版 SPA |
| make server + make app | 从配置的分支(重新)安装桌面服务端,然后启动 |
| make server-local + make app-local | 从本地未提交的源码安装桌面服务端,然后启动 |
| make pack-local | 从本地未提交的源码构建 macOS .app(无需推送) |
| make refs | 显示下一次运行将使用的分支引用 |
| make baseline | 将子模块重置为固定的提交版本 |
| make pin | 将当前子模块提交记录为超级项目的固定版本(一次明确的提交) |

子模块配置了 ignore = all,因此你在分支上的工作永远不会显示为超级项目的更改——父仓库的 git status 始终保持干净。固定版本只能通过 make pin 变更。完整流程见 CLAUDE.md。

 随处部署

MindsHub 的设计支持灵活部署——云端、VPC、本地部署、离线隔离环境以及混合基础设施——让你完全掌控自己的基础设施、模型、权限与数据。

 帮助与支持

- 提出问题 —— 加入 Discord 社区。
- 报告 Bug —— 提交 GitHub issue,并附上复现步骤。
- 查阅文档 —— 使用指南、部署说明与 API,见 docs.mindshub.ai。
- 企业级 SLA 或定制化部署 —— 联系我们。

 🤝 参与贡献

MindsHub 是开源项目,欢迎任何形式的贡献——代码、集成、文档、Bug 报告与功能建议。阅读文档完成环境搭建,浏览已有 issue,也欢迎到 Discord 打个招呼。

 🔒 安全

发现安全漏洞?请不要创建公开 issue。请通过我们的安全策略私下提交报告。

 📚 资源

- 文档
- 博客
- 品牌指南与媒体资料包
- Discord 社区

 📄 许可证

本仓库基于 MIT 许可证 发布。所捆绑