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
What is this?MindsHub Cowork is a unified workspace where you delegate entire projects - apps, websites, research, analysis, reports, scheduled operations - to AI models (open or proprietary) and get back finished, shareable results.
Is this a single app or a whole platform?This repo is the platform superproject that pins together the desktop/web client, the agent backend, and the data engine, so you can build and run the entire stack from source.
How do I get started with Cowork?Web users just open console.mindshub.ai and sign in; macOS and Windows users download the .pkg or .exe desktop app; on Linux you build it yourself from source with 'make dev' or 'make build'.
Any pitfalls with the local install?Linux has no ready-made installer, so you must build from source yourself. Also, 'make flush' wipes your local runtime and deletes all app state including conversations and saved provider keys, so use it carefully.
How does Cowork handle my connected data credentials?Credentials for connected systems like BigQuery, Postgres, or Gmail are stored in a secure vault and scoped per connection; agents only get access to the data, never the raw keys.
What is Anton?Anton is the default open-source agent harness that Cowork uses to run tasks; it is interchangeable with an alternative harness called Hermes via a dropdown.
Which AI models can I route work to?The Model Router lets you switch between frontier models like Claude, GPT, and Gemini, and open models like DeepSeek, Qwen, and Kimi, without wiring up a separate API key for each provider.
What are 'Artifacts' in Cowork?Artifacts are the documents, dashboards, apps, and code generated from agent output, which can be published to a live URL to share with your team.
What external data sources can Cowork connect to?A secure vault can link systems such as BigQuery, Postgres, Gmail, Drive, HubSpot, Notion, and Linear so agents can read and write real work data.
Creator
mindsdb
Size
275 MB
Stars
39.8K
Age
8y
Commits · 90 Days