mindshub README

The project's README from github.com/mindsdb/mindshub. As one markdown file: README.md.

MindsHub

The unified workspace where open-source models get things done for you.

Make AI do actual work. Swap the model anytime — keep everything you've built.

Release Stars License: MIT Python 3.10–3.13

Website · Docs · Web app · Pricing · Discord

Read this in: 中文 · Español · Português · हिन्दी

cowork

MindsHub Cowork is the unified workspace where you delegate entire projects — apps, websites, research, analysis, reporting, scheduled operations — and collect finished, shareable results. Connect your data, route work to any model (open or proprietary), run open-source agents, and turn their output into web applications you can publish. It's open source and runs anywhere — your machine, your VPC, or the hosted app.

This repository is the platform superproject: it pulls together the desktop/web app, the agent backend, and the data engine so you can build and run the whole stack from source.

Get started

Pick whichever fits:

Free to start. Pro adds all frontier models and private artifacts — see pricing.

What you can do

For every knowledge worker — creators, strategists, and operators:

What's inside

Build from source

1. Clone the repository

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

2. Install dependencies

make setup

3. Run

Mode Command
Desktop app (Electron) with hot reload make dev or make watch
Web app in browser with hot reload make dev-web
Production build make build
Package for macOS make dist-mac
Package for Windows make dist-win
Build macOS .app from local uncommitted source make pack-local
Wipe all local installs + data (fresh start) make flush

Fresh start: make flush removes the local runtime (the cowork-server uv tool and the backend/*/.venvs) and deletes app state in ~/.anton (provider keys) and ~/.cowork (database, hermes, projects). Use it to test the from-scratch install flow or recover from a broken install. It prompts for confirmation — pass FORCE=1 to skip. The next make setup or app launch reinstalls everything. ⚠️ This deletes your conversations and saved keys.

Working on feature branches (submodules)

This repo is a superproject that pins each module (frontend, backend/core_api, backend/core_agent, backend/data-vault) to a commit. To work on module branches without polluting git status or fighting over pins:

1. Pick your branches in a gitignored dev.env (copy the template):

cp dev.env.example dev.env      # then set REF=feat/my-thing (or per-module API_REF=…)

2. make follows it — one knob, both run paths:

Command What it does
make use check out your dev.env refs across all submodules
make dev / make watch run the Electron app with live reload against local source
make dev-web run the web SPA with live reload against local source
make server + make app (re)install the desktop server from the configured branch, then launch
make server-local + make app-local install the desktop server from local uncommitted source, then launch
make pack-local build the macOS .app from local uncommitted source (no push needed)
make refs show which refs the next run will use
make baseline reset submodules to the pinned commits
make pin record the current submodule commits as the superproject's pins (one deliberate commit)

Submodules are configured with ignore = all, so your branch work never shows up as superproject changes — the parent git status stays clean. Pins move only via make pin. See CLAUDE.md for the full workflow.

Deploy anywhere

Cowork is built for flexible deployment — cloud, VPC, on-prem, air-gapped, and hybrid infrastructure — so you keep full control over your infrastructure, models, permissions, and data.

Help & support

🤝 Contribute

Cowork is open source and contributions are welcome — code, integrations, docs, bug reports, and feature ideas. Read the docs to get set up, browse open issues, and say hi on Discord.

🔒 Security

Found a security vulnerability? Please don't open a public issue. Report it privately through our security policy.

📚 Resources

📄 License

This repository is released under the MIT License. Bundled components are governed by their own licenses — see each submodule's repository for details.

(back to top)

mindshub (mindsdb/mindshub)

Searching Database…

39.8K ·GitHub
Что это такое?MindsHub Cowork — это единое рабочее пространство, где вы поручаете ИИ-моделям (открытым или проприетарным) целые проекты: приложения, сайты, исследования, анализ, отчёты, регулярные операции по расписанию — и получаете готовые результаты, которыми можно поделиться.
Это одно приложение или целая платформа?Этот репозиторий — суперпроект платформы, который объединяет десктопный и веб-клиент, агентский бэкенд и движок данных, так что весь стек можно собрать и запустить из исходного кода.
Как мне начать работу с Cowork?Пользователи веба просто открывают console.mindshub.ai и входят в систему; пользователи macOS и Windows скачивают десктопное приложение в формате .pkg или .exe; на Linux приложение собирается самостоятельно из исходного кода командой 'make dev' или 'make build'.
Какие есть подводные камни при локальной установке?Для Linux нет готового установщика, поэтому собирать приложение из исходного кода придётся самому. Также команда 'make flush' полностью очищает локальную среду выполнения и удаляет всё состояние приложения, включая диалоги и сохранённые ключи провайдеров, поэтому используйте её осторожно.
Как Cowork обрабатывает мои учётные данные для подключённых источников данных?Учётные данные подключённых систем, таких как BigQuery, Postgres или Gmail, хранятся в защищённом хранилище и привязаны к каждому подключению; агенты получают доступ только к данным и никогда не видят исходные ключи.
Что такое Anton?Anton — это агентная среда с открытым исходным кодом по умолчанию, которую Cowork использует для выполнения задач; её можно заменить альтернативной средой Hermes через выпадающий список.
Какие модели ИИ я могу выбирать для задач?Model Router позволяет переключаться между передовыми моделями, такими как Claude, GPT и Gemini, и открытыми моделями, такими как DeepSeek, Qwen и Kimi, без настройки отдельного API-ключа для каждого провайдера.
Что такое «Артефакты» в Cowork?Артефакты — это документы, дашборды, приложения и код, созданные агентами, которые можно опубликовать по живой ссылке и поделиться с командой.
К каким внешним источникам данных может подключаться Cowork?Защищённое хранилище может связывать такие системы, как BigQuery, Postgres, Gmail, Drive, HubSpot, Notion и Linear, чтобы агенты могли читать и записывать реальные рабочие данные.
Creator
mindsdb
Size
275 MB
Stars
39.8K
Age
8y
Commits · 90 Days