https://github.com/mindsdb/mindshub
Make AI do actual work. Swap the model anytime — keep everything you've built.
https://github.com/mindsdb/mindshub
agents ai anton artificial-inteligence claude claude-cowork codex cowork deepseek glm hermes hermes-agent kimi mcp mindsdb
Last synced: 2 days ago
JSON representation
Make AI do actual work. Swap the model anytime — keep everything you've built.
- Host: GitHub
- URL: https://github.com/mindsdb/mindshub
- Owner: mindsdb
- License: mit
- Created: 2018-08-02T17:56:45.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2026-07-10T16:53:47.000Z (5 days ago)
- Last Synced: 2026-07-10T18:13:34.752Z (5 days ago)
- Topics: agents, ai, anton, artificial-inteligence, claude, claude-cowork, codex, cowork, deepseek, glm, hermes, hermes-agent, kimi, mcp, mindsdb
- Language: Makefile
- Homepage: https://mindshub.ai
- Size: 268 MB
- Stars: 39,390
- Watchers: 439
- Forks: 6,218
- Open Issues: 2
-
Metadata Files:
- Readme: README.es.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-ccamel - mindsdb/mindshub - Make AI do actual work. Swap the model anytime — keep everything you've built. (Makefile)
- stars - mindshub
- my-awesome - mindsdb/mindshub - inteligence,claude,claude-cowork,codex,cowork,deepseek,glm,hermes,hermes-agent,kimi,mcp,mindsdb pushed_at:2026-07 star:39.4k fork:6.2k Make AI do actual work. Swap the model anytime — keep everything you've built. (Makefile)
- awesome-rainmana - mindsdb/mindshub - Make AI do actual work. Swap the model anytime — keep everything you've built. (Makefile)
README
# MindsHub
**El espacio de trabajo unificado donde los modelos de código abierto hacen las cosas por ti.**
_Haz que la IA haga trabajo real. Cambia de modelo cuando quieras — conserva todo lo que has construido._
[](https://github.com/mindsdb/minds/releases)
[](https://github.com/mindsdb/minds/stargazers)
[](#-licencia)
[](https://www.python.org/downloads/)
[Sitio web](https://mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·
[Documentación](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·
[App web](https://console.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·
[Precios](https://mindshub.ai/pricing?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·
[Discord](https://mindshub.ai/discord)
**MindsHub Cowork** es el espacio de trabajo unificado donde delegas proyectos completos —apps, sitios web, investigación, análisis, informes, operaciones programadas— y recibes resultados terminados y listos para compartir. Conecta tus datos, dirige el trabajo a cualquier modelo (abierto o propietario), ejecuta agentes de código abierto y convierte su resultado en aplicaciones web que puedes publicar. Es de código abierto y funciona en cualquier lugar: tu máquina, tu VPC o la app alojada.
Este repositorio es el **superproyecto de la plataforma**: reúne la app de escritorio/web, el backend del agente y el motor de datos para que puedas construir y ejecutar toda la pila desde el código fuente.
## Primeros pasos
Elige lo que mejor te convenga:
- **Web — nada que instalar.** Abre **[console.mindshub.ai](https://console.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)** e inicia sesión.
- **macOS.** [Descarga la app de escritorio](https://downloads.mindsdb.com/mindshub-cowork/mac/mindshub-cowork-latest.pkg) (`.pkg`).
- **Windows.** [Descarga la app de escritorio](https://downloads.mindsdb.com/mindshub-cowork/windows/mindshub-cowork-latest.exe) (`.exe`).
- **Linux.** [Compílalo desde el código fuente](#compílalo-desde-el-código-fuente).
Gratis para empezar. Pro añade todos los modelos de vanguardia y artefactos privados — ver [precios](https://mindshub.ai/pricing?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme).
## Qué puedes hacer
Para cualquier trabajador del conocimiento —creadores, estrategas y operadores—:
- **Automatiza** trabajo repetitivo de varios pasos que implica leer y escribir: informes, monitoreo, flujos de trabajo recurrentes y operaciones programadas.
- **Crea** herramientas y artefactos internos de IA —apps, dashboards, presentaciones, documentos, análisis— sin necesidad de ingeniería, y publícalos en una URL en vivo para compartir con tu equipo.
## Qué incluye
- **Datos conectados.** Un vault seguro conecta sistemas como BigQuery, Postgres, Gmail, Drive, HubSpot, Notion y Linear. Las credenciales quedan delimitadas por conexión —los agentes nunca ven las claves en bruto.
- **Model Router.** Cambia entre modelos de vanguardia (Claude, GPT, Gemini) y modelos abiertos (DeepSeek, Qwen, Kimi) sin configurar una clave para cada proveedor.
- **Agentes abiertos.** Ejecuta harnesses de código abierto intercambiables —Anton (por defecto) y Hermes— seleccionables desde un menú desplegable.
- **Artefactos.** Convierte la salida del agente en documentos, dashboards, apps y código, y publícalo en una URL en vivo.
- **Memoria, habilidades y programación.** Memoria entre sesiones, una biblioteca de habilidades reutilizable y tareas que se ejecutan según un horario.
## Compílalo desde el código fuente
**1. Clona el repositorio**
```bash
git clone --recurse-submodules https://github.com/mindsdb/minds.git
cd minds
```
**2. Instala las dependencias**
```bash
make setup
```
**3. Ejecuta**
| Modo | Comando |
|---|---|
| App de escritorio (Electron) con hot reload | `make dev` o `make watch` |
| App web en el navegador con hot reload | `make dev-web` |
| Build de producción | `make build` |
| Empaquetar para macOS | `make dist-mac` |
| Empaquetar para Windows | `make dist-win` |
| Compilar la `.app` de macOS desde código local sin confirmar | `make pack-local` |
| Borrar todas las instalaciones y datos locales (empezar de cero) | `make flush` |
> **Empezar de cero:** `make flush` elimina el runtime local (la herramienta uv `cowork-server` y los `backend/*/.venv`) y borra el estado de la app en `~/.anton` (claves de proveedores) y `~/.cowork` (base de datos, hermes, proyectos). Úsalo para probar el flujo de instalación desde cero o para recuperarte de una instalación rota. Pide confirmación —pasa `FORCE=1` para omitirla. El siguiente `make setup` o el próximo arranque de la app reinstala todo. ⚠️ Esto elimina tus conversaciones y claves guardadas.
### Trabajar en ramas de funcionalidades (submódulos)
Este repositorio es un superproyecto que fija (pin) cada módulo (`frontend`, `backend/core_api`, `backend/core_agent`, `backend/data-vault`) a un commit. Para trabajar en ramas de los módulos sin ensuciar el `git status` ni pelear por los pins:
**1. Elige tus ramas** en un `dev.env` (ignorado por git, cópialo de la plantilla):
```bash
cp dev.env.example dev.env # luego define REF=feat/mi-cosa (o por módulo API_REF=…)
```
**2. `make` sigue esa configuración** —un solo ajuste, para ambas formas de ejecutar:
| Comando | Qué hace |
|---|---|
| `make use` | hace checkout de las ramas de `dev.env` en todos los submódulos |
| `make dev` / `make watch` | ejecuta la app Electron con hot reload contra el código local |
| `make dev-web` | ejecuta la SPA web con hot reload contra el código local |
| `make server` + `make app` | (re)instala el servidor de escritorio desde la rama configurada y lo lanza |
| `make server-local` + `make app-local` | instala el servidor de escritorio desde **código local sin confirmar** y lo lanza |
| `make pack-local` | compila la `.app` de macOS desde código local sin confirmar (sin necesidad de push) |
| `make refs` | muestra qué referencias usará la próxima ejecución |
| `make baseline` | restablece los submódulos a los commits fijados |
| `make pin` | registra los commits actuales de los submódulos como los pins del superproyecto (un commit deliberado) |
Los submódulos están configurados con `ignore = all`, así que tu trabajo en ramas nunca aparece como cambios del superproyecto —el `git status` del repositorio padre se mantiene limpio. Los pins solo se mueven con `make pin`. Consulta [`CLAUDE.md`](CLAUDE.md) para el flujo completo.
## Despliega en cualquier lugar
Cowork está diseñado para un despliegue flexible —infraestructura **en la nube, VPC, on-prem, air-gapped e híbrida**— para que mantengas el control total sobre tu infraestructura, modelos, permisos y datos.
## Ayuda y soporte
- **Haz una pregunta** — únete a la [comunidad de Discord](https://mindshub.ai/discord).
- **Reporta un bug** — abre un [issue en GitHub](https://github.com/mindsdb/minds/issues) con los pasos para reproducirlo.
- **Lee la documentación** — guías, configuración y la API en [docs.mindshub.ai](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme).
- **SLAs empresariales o despliegues a medida** — [contacta al equipo](https://mindshub.ai/contact?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme).
## 🤝 Contribuir
Cowork es de código abierto y las contribuciones son bienvenidas —código, integraciones, documentación, reportes de bugs e ideas de funcionalidades. Lee la [documentación](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) para configurarte, explora los [issues abiertos](https://github.com/mindsdb/minds/issues) y saluda en [Discord](https://mindshub.ai/discord).
## 🔒 Seguridad
¿Encontraste una vulnerabilidad de seguridad? Por favor **no** abras un issue público. Repórtala de forma privada a través de nuestra [política de seguridad](https://github.com/mindsdb/minds/security).
## 📚 Recursos
- [Documentación](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)
- [Blog](https://mindshub.ai/blog?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)
- [Guías de marca y kit de prensa](https://mindshub.ai/press-kit?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)
- [Comunidad de Discord](https://mindshub.ai/discord)
## 📄 Licencia
Este repositorio se publica bajo la [Licencia MIT](LICENSE). Los componentes incluidos se rigen por sus propias licencias —consulta el repositorio de cada submódulo para más detalles.