{"repo":"mindsdb/mindshub","free":true,"listed":false,"github":"https://github.com/mindsdb/mindshub","clone":"git clone https://github.com/mindsdb/mindshub.git","description":"The unified workspace where open-source models get things done for you.","language":"Makefile","stars":39589,"topics":["agents","ai","anton","artificial-inteligence","claude","claude-cowork","codex","cowork","deepseek","glm","hermes","hermes-agent","kimi","mcp","mindsdb"],"license":"MIT","category":"ai_workflow_platform","readme_excerpt":"\n\n
\n\n# MindsHub \n\n**The unified workspace where open-source models get things done for you.**\n\n_Make AI do actual work. Swap the model anytime — keep everything you've built._\n\n[![Release](https://img.shields.io/github/v/release/mindsdb/minds?logo=github&label=release)](https://github.com/mindsdb/minds/releases)\n[![Stars](https://img.shields.io/github/stars/mindsdb/minds?logo=github)](https://github.com/mindsdb/minds/stargazers)\n[![License: MIT](https://img.shields.io/github/license/mindsdb/minds)](#-license)\n[![Python 3.10–3.13](https://img.shields.io/badge/python-3.10%20–%203.13-brightgreen.svg)](https://www.python.org/downloads/)\n\n[Website](https://mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·\n[Docs](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·\n[Web app](https://console.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·\n[Pricing](https://mindshub.ai/pricing?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·\n[Discord](https://mindshub.ai/discord)\n\n

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

\n\n
\n\n

\n \"cowork\"\n\n\n\n

\n\n**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.\n\nThis 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.\n\n## Get started\n\nPick whichever fits:\n\n- **Web — nothing to install.** Open **[console.mindshub.ai](https://console.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)** and sign in.\n- **macOS.** [Download the desktop app](https://downloads.mindsdb.com/mindshub-cowork/mac/mindshub-cowork-latest.pkg) (`.pkg`).\n- **Windows.** [Download the desktop app](https://downloads.mindsdb.com/mindshub-cowork/windows/mindshub-cowork-latest.exe) (`.exe`).\n- **Linux.** [Build from source](#build-from-source).\n\nFree to start. Pro adds all frontier models and private artifacts — see [pricing](https://mindshub.ai/pricing?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme).\n\n## What you can do\n\nFor every knowledge worker — creators, strategists, and operators:\n\n- **Automate** repetitive, multi-step work that involves reading and writing: reports, monitoring, recurring workflows, and scheduled operations.\n- **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.\n\n## What's inside\n\n- **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.\n- **Model Router.** Switch between frontier models (Claude, GPT, Gemini) and open models (DeepSeek, Qwen, Kimi) without wiring up a key for each provider.\n- **Open agents.** Run interchangeable open-source harnesses — Anton (default) and Hermes — swappable from a dropdown.\n- **Artifacts.** Turn agent output into documents, dashboards, apps, and code, and publish to a live URL.\n- **Memory, skills & scheduling.** Cross-session memory, a reusable skill library, and tasks that run on a schedule.\n\n## Build from source\n\n**1. Clone the repository**\n\n```bash\ngit clone --recurse-submodules https://github.com/mindsdb/minds.git\ncd minds\n```\n\n**2. Install dependencies**\n\n```bash\nmake setup\n```\n\n**3. Run**\n\n| Mode | Command |\n|---|---|\n| Desktop app (Electron) with hot reload | `make dev` or `make watch` |\n| Web app in browser with hot reload | `make dev-web` |\n| Production build | `make build` |\n| Package for macOS | `make dist-mac` |\n| Package for Windows | `make dist-win` |\n| Build macOS `.app` from local uncommitted source | `make pack-local` |\n| Wipe all local installs + data (fresh start) | `make flush` |\n\n> **Fresh start:** `make flush` removes the local runtime (the `cowork-server` uv tool and the `backend/*/.venv`s) 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.\n\n### Working on feature branches (submodules)\n\nThis 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:\n\n**1. Pick your branches** in a gitignored `dev.env` (copy the template):\n\n```bash\ncp dev.env.example dev.env # then set REF=feat/my-thing (or per-module API_REF=…)\n```\n\n**2. `make` follows it** — one knob, both run paths:\n\n| Command | What it does |\n|---|---|\n| `make use` | check out your `dev.env` refs across all submodules |\n| `make dev` / `make watch` | run the Electron app with live reload against local source |\n| `make dev-web` | run the web SPA with live reload against local source |\n| `make server` + `make app` | (re)install the desktop server from the configured branch, then launch |\n| `make server-local` + `make app-local` | install the desktop server from **local uncommitted source**, then launch |\n| `make pack-local` | build the macOS `.app` from local uncommitted source (no push needed) |\n| `make refs` | show which refs the next run will use |\n| `make baseline` | reset submodules to the pinned commits |\n| `make pin` | record the current submodule commits as the superproject's pins (one deliberate commit) |\n\nSubmodules 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`](CLAUDE.md) for the full workflow.\n\n## Deploy anywhere\n\nCowork 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.\n\n## Help & support\n\n- **Ask a question** — join the [Discord community](https://mindshub.ai/discord).\n- **Report a bug** — open a [GitHub issue](https://github.com/mindsdb/minds/issues) with reproduction steps.\n- **Read the docs** — guides, setup, and the API at [docs.mindshub.ai](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme).\n- **Enterprise SLAs or custom deployments** — [contact the team](https://mindshub.ai/contact?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme).\n\n## 🤝 Contribute\n\nCowork is open source and contributions are welcome — code, integrations, docs, bug reports, and feature ideas. Read the [docs](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) to get set up, browse [open issues](https://github.com/mindsdb/minds/issues), and say hi on [Discord](https://mindshub.ai/discord).\n\n## 🔒 Security\n\nFound a security vulnerability? Please **don't** open a public issue. Report it privately through our [security policy](https://github.com/mindsdb/minds/security).\n\n## 📚 Resources\n\n- [Documentation](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)\n- [Blog](https://mindshub.ai/blog?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)\n- [Brand guidelines & press kit](https://mindshub.ai/press-kit?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)\n- [Discord community](https://mindshub.ai/discord)\n\n## 📄 License\n\nThis repository is released under the [MIT License](LICENSE). Bundled components are governed by their own licenses — see each submodule's repository for details.\n\n

(back to top)

\n","default_branch":"main","files":39,"tree":[".devcontainer/devcontainer.json",".github/CODEOWNERS",".github/ISSUE_TEMPLATE/bug_report_v2.yaml",".github/ISSUE_TEMPLATE/config.yml",".github/ISSUE_TEMPLATE/feature_request_v2.yaml",".github/ISSUE_TEMPLATE/improve_docs_v1.yaml",".github/ISSUE_TEMPLATE/integrations_contest.yaml",".github/pull_request_template.md",".github/workflows/codeql.yml",".github/workflows/deploy_docs.yml",".gitignore",".gitmodules","CLAUDE.md","CODE_OF_CONDUCT.md","CONTRIBUTING.md","LICENSE","Makefile","README.es.md","README.hi.md","README.md","README.pt.md","README.zh.md","SECURITY.md","assets/contributions-agreement/entity-contributor.md","assets/contributions-agreement/individual-contributor.md","assets/contributions-agreement/signatures/cla.json","dev.env.example","docker-compose.yml","docker/api.Dockerfile","docker/nginx.conf","docker/web.Dockerfile","docs/api.html","docs/docs.json","docs/favicon-dark.png","docs/favicon.png","docs/favicon_old.png","docs/index.html","docs/setup.html","docs/use-cases.html"],"storefront":"/r/mindsdb","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/mindsdb/mindshub/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}