<a name="readme-top"></a>

<div align="center">

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.

Website · Docs · Web app · Pricing · Discord

<p align="center"> _{Read this in: <a href="README.zh.md">中文</a> · <a href="README.es.md">Español</a> · <a href="README.pt.md">Português</a> · <a href="README.hi.md">हिन्दी</a>} </p> </div> <p align="center"> <img width="640" height="480" alt="cowork" src="https://github.com/user-attachments/assets/048761b8-aa77-4506-9c4d-32e2fdecbb60" /> </p>

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:

• Web — nothing to install. Open console.mindshub.ai and sign in.
• macOS. Download the desktop app (.pkg).
• Windows. Download the desktop app (.exe).
• Linux. Build from source.

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:

• Automate repetitive, multi-step work that involves reading and writing: reports, monitoring, recurring workflows, and scheduled operations.
• Build internal AI tools and artifacts — apps, dashboards, decks, docs, analyses — without engineering, and publish them to a live URL to share with your team.

What's inside

• Connected data. A secure vault links systems like BigQuery, Postgres, Gmail, Drive, HubSpot, Notion, and Linear. Credentials stay scoped per connection — agents never see raw keys.
• Model Router. Switch between frontier models (Claude, GPT, Gemini) and open models (DeepSeek, Qwen, Kimi) without wiring up a key for each provider.
• Open agents. Run interchangeable open-source harnesses — Anton (default) and Hermes — swappable from a dropdown.
• Artifacts. Turn agent output into documents, dashboards, apps, and code, and publish to a live URL.
• Memory, skills & scheduling. Cross-session memory, a reusable skill library, and tasks that run on a schedule.

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

• Ask a question — join the Discord community.
• Report a bug — open a GitHub issue with reproduction steps.
• Read the docs — guides, setup, and the API at docs.mindshub.ai.
• Enterprise SLAs or custom deployments — contact the team.

🤝 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

• Documentation
• Blog
• Brand guidelines & press kit
• Discord community

📄 License

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

<p align="right">(<a href="#readme-top">back to top</a>)</p>