KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #claude-code #dsh #dsh-plugin #cli #deepseek-harness #macos #ai-agent #open-source

mindshub

★ 39,589 Open GitHub ↗

AI로 실제 업무를 수행하세요. 언제든지 모델을 교체하면서 구축한 모든 것을 유지할 수 있습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MindsHub

**오픈소스 모델이 실질적인 업무를 처리해 주는 통합 작업 공간입니다.**

_AI로 실제 업무를 수행하세요. 언제든지 모델을 교체하면서 구축한 모든 것을 유지할 수 있습니다._

[![Release](https://img.shields.io/github/v/release/mindsdb/minds?logo=github&label=release)](https://github.com/mindsdb/minds/releases)
[![Stars](https://img.shields.io/github/stars/mindsdb/minds?logo=github)](https://github.com/mindsdb/minds/stargazers)
[![License: MIT](https://img.shields.io/github/license/mindsdb/minds)](https://raw.githubusercontent.com/mindsdb/mindshub/main/)
[![Python 3.10–3.13](https://img.shields.io/badge/python-3.10%20–%203.13-brightgreen.svg)](https://www.python.org/downloads/)

[Website](https://mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·
[Docs](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·
[Web app](https://console.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·
[Pricing](https://mindshub.ai/pricing?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme) ·
[Discord](https://mindshub.ai/discord)

<p align="center">
  <sub>다음 언어로 읽기: <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></sub>
</p>

</div>

</p>

**MindsHub Cowork**는 앱, 웹사이트, 리서치, 분석, 리포팅, 예약 작업 등 전체 프로젝트를 위임하고 완성된 공유 가능 결과물을 수집할 수 있는 통합 작업 공간입니다. 데이터를 연결하고, 원하는 모델(오픈소스 또는 상용)로 작업을 라우팅하며, 오픈소스 에이전트를 실행하고, 그 결과물을 퍼블리시할 수 있는 웹 애플리케이션으로 전환할 수 있습니다. 오픈소스이며 로컬 머신, VPC, 호스티드 앱 등 어디서나 실행할 수 있습니다.

이 저장소는 **플랫폼 슈퍼프로젝트**로, 데스크톱/웹 앱, 에이전트 백엔드, 데이터 엔진을 하나로 묶어 소스 코드를 통해 전체 스택을 빌드하고 실행할 수 있도록 합니다.

## 시작하기

상황에 맞는 방식을 선택하세요:

- **웹 — 설치가 필요 없습니다.** **[console.mindshub.ai](https://console.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)**에 접속하여 로그인하세요.
- **macOS.** [데스크톱 앱 다운로드](https://downloads.mindsdb.com/mindshub-cowork/mac/mindshub-cowork-latest.pkg) (`.pkg`).
- **Windows.** [데스크톱 앱 다운로드](https://downloads.mindsdb.com/mindshub-cowork/windows/mindshub-cowork-latest.exe) (`.exe`).
- **Linux.** [소스에서 빌드하기](#build-from-source).

무료로 시작할 수 있습니다. Pro 버전에는 모든 최첨단(frontier) 모델과 프라이빗 아티팩트가 포함됩니다. [요금제](https://mindshub.ai/pricing?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)를 확인하세요.

## 주요 기능

크리에이터, 전략가, 운영자 등 모든 지식 노동자를 위한 기능:

- **자동화:** 읽기 및 쓰기가 포함된 반복적인 다단계 업무(보고서, 모니터링, 반복 워크플로우, 예약 작업)를 자동화합니다.
- **구축:** 엔지니어링 없이 내부 AI 도구 및 아티팩트(앱, 대시보드, 덱, 문서, 분석)를 구축하고, 라이브 URL로 배포하여 팀과 공유할 수 있습니다.

## 포함된 구성 요소

- **연결된 데이터:** 안전한 볼트를 통해 BigQuery, Postgres, Gmail, Drive, HubSpot, Notion, Linear 등의 시스템을 연결합니다. 인증 정보는 연결별로 범위가 지정되며, 에이전트는 원본 키를 볼 수 없습니다.
- **모델 라우터:** 각 제공자별로 키를 설정할 필요 없이 최첨단 모델(Claude, GPT, Gemini)과 오픈 모델(DeepSeek, Qwen, Kimi) 간에 자유롭게 전환할 수 있습니다.
- **오픈 에이전트:** 드롭다운을 통해 교체 가능한 오픈소스 하니스(기본값인 Anton 및 Hermes)를 실행합니다.
- **아티팩트:** 에이전트의 결과물을 문서, 대시보드, 앱, 코드로 전환하고 라이브 URL로 배포합니다.
- **메모리, 스킬 및 스케줄링:** 세션 간 메모리, 재사용 가능한 스킬 라이브러리, 일정에 따라 실행되는 작업 기능을 제공합니다.

## 소스에서 빌드하기

**1. 저장소 복제하기**

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

**2. 의존성 설치하기**

```bash
make setup
```

**3. 실행하기**

| 모드 | 명령어 |
|---|---|
| 핫 리로드 기능이 있는 데스크톱 앱(Electron) | `make dev` 또는 `make watch` |
| 핫 리로드 기능이 있는 브라우저 웹 앱 | `make dev-web` |
| 프로덕션 빌드 | `make build` |
| macOS용 패키지 빌드 | `make dist-mac` |
| Windows용 패키지 빌드 | `make dist-win` |
| 로컬 커밋되지 않은 소스에서 macOS `.app` 빌드 | `make pack-local` |
| 모든 로컬 설치 및 데이터 삭제(클린 시작) | `make flush` |

> **클린 시작:** `make flush` 명령어는 로컬 런타임(`cowork-server` uv 도구 및 `backend/*/.venv`)을 제거하고 `~/.anton`(제공자 키) 및 `~/.cowork`(데이터베이스, hermes, 프로젝트)의 앱 상태를 삭제합니다. 처음부터 다시 설치하는 플로우를 테스트하거나 깨진 설치 상태를 복구할 때 사용하세요. 확인 프롬프트를 표시하며, 건너뛰려면 `FORCE=1`을 전달하세요. 이후 `make setup` 또는 앱을 실행하면 모든 것이 재설치됩니다. ⚠️ 이 작업은 대화 내용과 저장된 키를 삭제합니다.

### 기능 브랜치(서브모듈) 작업하기

이 저장소는 각 모듈(`frontend`, `backend/core_api`, `backend/core_agent`, `backend/data-vault`)을 특정 커밋에 고정(pin)하는 슈퍼프로젝트입니다. `git status`를 오염시키거나 고정 버전 충돌 없이 모듈 브랜치에서 작업하려면:

**1. gitignore된 `dev.env`에서 브랜치를 선택하세요** (템플릿 복사):

```bash
cp dev.env.example dev.env      # 이후 REF=feat/my-thing 설정 (또는 모듈별 API_REF=…)
```

**2. `make` 명령어가 이를 따릅니다** — 하나의 설정으로 양쪽 실행 경로 모두 적용:

| 명령어 | 설명 |
|---|---|
| `make use` | 모든 서브모듈에 걸쳐 `dev.env`의 ref 체크아웃 |
| `make dev` / `make watch` | 로컬 소스를 기반으로 라이브 리로드와 함께 Electron 앱 실행 |
| `make dev-web` | 로컬 소스를 기반으로 라이브 리로드와 함께 웹 SPA 실행 |
| `make server` + `make app` | 설정된 브랜치에서 데스크톱 서버를 (재)설치한 후 실행 |
| `make server-local` + `make app-local` | **로컬 커밋되지 않은 소스**에서 데스크톱 서버를 설치한 후 실행 |
| `make pack-local` | 로컬 커밋되지 않은 소스에서 macOS `.app` 빌드 (푸시 불필요) |
| `make refs` | 다음 실행 시 사용할 ref 확인 |
| `make baseline` | 서브모듈을 고정된 커밋으로 리셋 |
| `make pin` | 현재 서브모듈 커밋을 슈퍼프로젝트의 고정 버전으로 기록 (단일 커밋) |

서브모듈은 `ignore = all`로 설정되어 있으므로, 브랜치 작업 내용이 슈퍼프로젝트의 변경 사항으로 표시되지 않으며 상위 `git status`가 깔끔하게 유지됩니다. 고정 버전은 `make pin`을 통해서만 변경됩니다. 전체 워크플로우는 [`CLAUDE.md`](CLAUDE.md)를 참조하세요.

## 어디서나 배포 가능

Cowork는 유연한 배포(**클라우드, VPC, 온프레미스, 에어갭, 하이브리드** 인프라)를 지원하도록 설계되어 인프라, 모델, 권한, 데이터를 완전히 제어할 수 있습니다.

## 도움말 및 지원

- **질문하기** — [Discord 커뮤니티](https://mindshub.ai/discord)에 참여하세요.
- **버그 신고하기** — 재현 단계와 함께 [GitHub 이슈](https://github.com/mindsdb/minds/issues)를 열어주세요.
- **문서 읽기** — 가이드, 설치 방법, API 문서는 [docs.mindshub.ai](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)에서 확인하세요.
- **엔터프라이즈 SLA 또는 맞춤형 배포** — [팀에 문의하기](https://mindshub.ai/contact?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme).

## 🤝 기여하기

Cowork는 오픈소스이며 코드, 연동 기능, 문서, 버그 신고, 기능 아이디어 등 기원을 환영합니다. [문서](https://docs.mindshub.ai/?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)를 읽고 환경을 설정한 뒤, [열린 이슈](https://github.com/mindsdb/minds/issues)를 둘러보고 [Discord](https://mindshub.ai/discord)에서 인사를 건네주세요.

## 🔒 보안

보안 취약점을 발견하셨나요? 공개 이슈를 열지 **마시고**, [보안 정책](https://github.com/mindsdb/minds/security)을 통해 비공개로 신고해 주세요.

## 📚 리소스

- [문서 (Documentation)](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)
- [브랜드 가이드라인 및 프레스 키트](https://mindshub.ai/press-kit?utm_source=github&utm_medium=repo-readme&utm_campaign=minds-readme)
- [Discord 커뮤니티](https://mindshub.ai/discord)

## 📄 라이선스

이 저장소는 [MIT 라이선스](LICENSE)에 따라 배포됩니다. 번들로 제공되는 컴포넌트는 각자의 라이선스를 따르며, 자세한 내용은 각 서브모듈의 저장소를 참조하세요.

mindshub

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README