English | 简体中文
<p align="center">
<a href="https://xpertai.cn/en/">
<img src="https://raw.githubusercontent.com/xpert-ai/xpert/HEAD/docs/images/logo.png" alt="Xpert AI" width="220">
</a>
</p>
<h1 align="center">Xpert Platform & Xpert Bosi</h1>
<p align="center">
Xpert는 AI 팀을 구축하고 관리하는 오픈 소스 플랫폼입니다.<br> Xpert Bosi는 이의 데스크톱 애플리케이션으로, 사용자의 AI 팀 리더 역할을 합니다.
</p>
<p align="center">
<a href="https://github.com/xpert-ai/xpert/releases"><strong class="">Bosi 다운로드</strong></a> ·
<a href="https://app.xpertai.cn/plugins/marketplace"><strong class="">마켓플레이스 탐색</strong></a> ·
<a href="https://docs.xpertai.cn/en/ai/getting-started/community"><strong class="">Xpert 자체 호스팅</strong></a> ·
<a href="https://docs.xpertai.cn/en/">문서(Documentation)</a>
</p>
<p align="center">
<a href="https://github.com/xpert-ai/xpert">
<img src="https://img.shields.io/github/stars/xpert-ai/xpert?style=flat&logo=github" alt="GitHub stars">
</a>
<a href="https://www.npmjs.com/package/@xpert-ai/contracts">
<img src="https://img.shields.io/npm/v/@xpert-ai/contracts.svg?logo=npm&logoColor=fff&label=contracts" alt="@xpert-ai/contracts on npm">
</a>
<a href="LICENSES.md">
<img src="https://img.shields.io/badge/Community-AGPL--3.0-blue" alt="Community Edition: AGPL-3.0">
</a>
</p>
Xpert Bosi — 사용자의 AI 팀 리더
사용자가 목표를 설정합니다. Bosi가 팀을 이끌어갑니다.
Bosi는 Xpert의 디지털 전문가, 플러그인 및 애플리케이션을 데스크톱에서 통합합니다. Xpert 계정으로 로그인하고 조직의 권한 내에서 작업할 수 있습니다.
- 팀 구성하기 (Assemble your team): 전문가를 발견하거나, 접근 권한을 요청하거나, 템플릿 및 앱에서 Assistants를 생성할 수 있습니다.
- 한 곳에서 작업하기 (Work in one place): 대화, 파일, 앱 Workbench 뷰를 결합하고; 워크스페이스 플러그인을 추가하여 각 대화에 선택할 수 있습니다.
- 계획을 실행으로 옮기기 (Put plans into action): 구성된 Assistants를 사용하여 클라우드 컴퓨터를 운영하거나 macOS에서 로컬 Shell 명령을 실행할 수 있으며, 기본적으로 명령어별 승인이 필요합니다.
Bosi는 호스팅되거나 자체 호스팅되는 Xpert에 연결됩니다. 이 플랫폼은 Agents를 실행하고 공유 리소스를 관리하며; Bosi는 데스크톱 경험과 승인된 로컬 실행 기능을 제공합니다. 설정 및 빌드는 데스크톱 가이드를 참조하십시오.
Bosi 다운로드
macOS, Windows, Linux용으로 이용 가능합니다. GitHub 릴리스에서 다운로드 · 웹사이트 다운로드 페이지.
Bosi, Xpert Web 또는 자체 제품에서 사용되는 AI 팀을 구축하고 게시하십시오. Xpert는 런타임(runtime), 권한(permissions), 승인(approvals), 감사 추적(audit trails)을 제공하며; 플러그인은 모델 공급자 및 도구부터 완전한 Agentic Apps까지 기능을 제공합니다.
- 단일 플러그인 수명 주기 (One plugin lifecycle): 모델, 통합(integrations), Skills, 미들웨어(middleware), MCP 앱, 비즈니스 애플리케이션을 설치하고 구성하며 발전시킬 수 있습니다.
- Agent + 워크플로우 (Workflow): 유연한 추론과 결정론적이고 검사 가능한 비즈니스 프로세스를 결합합니다.
- 관리되는 실행 (Governed execution): 타입이 지정된 도구(typed tools), 의미론적 객체(semantic objects), 정책(policies), 승인을 통해 데이터와 액션을 노출합니다.
- 검토 가능한 작업 (Reviewable work): 전용 Workbench 뷰에서 결과를 검사하고, 수정하고, 승인하고, 제출할 수 있습니다.
공식 앱 (Official Apps)
공식 앱 카탈로그에서 AI 팀을 위한 애플리케이션을 발견하십시오.
빠른 시작 (Quick Start)
Bosi 사용: 데스크톱 앱을 다운로드 및 설치하고, 로그인한 후, 조직(organization)을 선택하고 **탐색 및 추가(Discover & add)**를 열어 전문가(experts), 앱(apps), 플러그인(plugins), 템플릿(templates)을 찾으세요. 자체 호스팅 사용자(Self-hosted users)는 로그인하기 전에 서버를 구성할 수 있습니다. 데스크톱 가이드를 참조하세요.
Xpert 호스팅: CPU 코어 2개, RAM 4 GiB, Docker, 그리고 Docker Compose가 필요합니다.
git clone https://github.com/xpert-ai/xpert.git
cd xpert/docker
cp env.example .env
...
http://localhost/를 열고 Bosi에 연결하기 전에 초기화(initialization)를 완료하세요.
배포 및 업그레이드를 참조하세요. 소스 개발을 위해서는 지원되는 Node.js LTS 버전과 Corepack을 통한 저장소 고정(repository-pinned) pnpm이 필요합니다.
| 영역 (Area) | 기능 설명 (What it enables) |
|---|
| Agent Studio | 디지털 전문가, 다중 에이전트 워크플로우(multi-agent workflows), 도구(tools), 지식(knowledge), 미들웨어(middleware)를 작성합니다. |
| ... | |
아키텍처 (Architecture)
Xpert는 플러그인 우선(plugin-first)의 모듈형 NestJS 플랫폼입니다. 공유되는 **에이전트 + 워크플로우 런타임(Agent + Workflow runtime)**이 AI 팀을 구동하며, **에이전틱 앱(Agentic Apps)**은 도메인 도구, 어시스턴트 템플릿, 비즈니스 서비스 및 인터랙티브 Workbench 뷰를 결합하여 완전한 애플리케이션을 만듭니다.
Xpert architecture: AI Agent execution loops, multi-agent coordination, workflows, plugin capabilities, and Agentic Apps
- AI 에이전트 및 워크플로우: 에이전트 정의는 LangGraph 상태 그래프로 컴파일됩니다. 모델-도구 루프는 컨텍스트, 도구 라우팅, 미들웨어 후크, 그리고 도구 결과를 결합합니다. 워크플로우는 브랜치, 병렬 경로, 반복(iteration), 서브플로우를 추가합니다. 도구 기반의 서브 에이전트 위임, 게시된 전문가(published experts), 그리고 Swarm 핸드오프가 다양한 협업 패턴을 지원합니다. 체크포인트는 중단 및 사용자 입력을 위해 상태를 보존하며, AgentInvocation은 네이티브 및 외부 런타임 호출을 관리합니다.
- 플러그인 시스템: 네이티브 npm 플러그인은 NestJS 모듈, 프로바이더, 구성, 그리고 라이프사이클 후크를 등록합니다. 확장 지점(Extension points)은 모델, 도구/MCP, 미들웨어, 스킬/템플릿, 워크플로우, 통합(integrations), 커넥터, 데이터/RAG, 실행, 저장소, 뷰, 그리고 협업을 포괄합니다.
- 대화 리소스: 표준 Agent Plugin 패키지는 Git/ZIP 가져오기를 통해 스킬/MCP 리소스를 공급합니다. 워크스페이스 권한(Workspace grants), 버전 관리 바인딩, 및 실행별 리소스 스냅샷이 사용을 제어하며, 서버 코드를 로드하지는 않습니다.
- 에이전트 앱 (Agentic Apps): 마켓플레이스 기여물은 도구, 템플릿, 비즈니스 서비스, 그리고 리뷰 뷰를 연결합니다.
appConfig를 선언하는 앱은 호스트 관리의 프리플라이트(preflight), 전용 워크스페이스, 지식 기반(knowledgebases), 게시된 어시스턴트 또는 역할 스위트, 그리고 설치 상태 추적을 사용합니다.
- 공유 런타임 및 UI 계약: LangGraph / LangChain, CQRS, Bull 핸드오프, 체크포인트, 그리고 중단/재개 기능이 실행의 기반이 됩니다. Workbench는 View Manifests, View Providers, 그리고 iframe 브리지를 사용하며; MCP 앱은 도구 연결형 UI 리소스를 사용합니다.
- 관리되는 인프라: 범위가 지정된 ID(scoped identities), 승인, 감사(audit), 및 사용량은 API, 워커, 플러그인을 아우릅니다. PostgreSQL + pgvector, Redis, 그리고 스토리지 프로바이더가 상태를 영속화합니다. Data Xpert는 별도의 API/MCP 연결 서비스이며; Pro 실행 프로바이더는 명시적으로 표시됩니다.
전체 해상도를 보려면 다이어그램을 여세요. AI 에이전트 아키텍처 및 소스 맵 · 에이전트–워크플로우 아키텍처 기사
에코시스템 (Ecosystem)
| Repository | 목적 |
|---|
xpert-plugins | 공식 및 커뮤니티 통합, 모델 제공업체, 미들웨어, 도구, 스킬(Skills), 에이전트 앱 (Agentic Apps). |
| ... | |
에이전트 스킬을 사용한 로컬 개발
Codex를 위해 필요한 xpert-skills를 설치하여 Xpert를 설정하거나, 플러그인을 빌드하거나, 자체 애플리케이션을 통합할 수 있습니다. 프로젝트 전용 설치를 하려면 --global 옵션을 제거하고, 다른 지원 에이전트를 사용하려면 codex를 대체하세요.
플랫폼 플러그인 시스템 외의 애플리케이션에는 다음 중 하나를 선택하세요:
xpert-chatkit-integration: 공식 ChatKit 문서를 따라 애플리케이션에 ChatKit 채팅 UI를 임베드합니다.xpert-sdk-integration: ChatKit 없이 서비스, 스크립트 또는 사용자 정의 인터페이스에서 SDK를 사용하며, 공식 SDK 문서를 따릅니다.
npx skills add xpert-ai/xpert-skills \
--skill xpert-platform-local-environment \
--agent codex \
...
설치 후 새로운 에이전트 세션을 시작하세요. 플랫폼 플러그인 개발을 위해서는 다음 질문에 답하세요:
-
Xpert 설정 및 검증
$xpert-platform-local-environment를 사용하여 소스 하이브리드 모드(source-hybrid mode)로 <path>의 Xpert를 설정하고 플러그인 테스트 준비 상태인지 확인합니다.
-
에이전트 앱 빌드
$xpert-agentic-app-developer를 사용하여 해당 인스턴스에서 독립적인 플러그인으로 <앱 설명>을 빌드, 배포 및 검증합니다.
환경 스킬은 API와 Web UI를 소스에서 Docker 인프라로 실행합니다. 앱 스킬은 도구, 뷰, 템플릿 및 승인(acceptance)을 다루며, xpert-plugin-development가 패키징과 배포를 담당합니다.
로드맵 (ROADMAP)
- 계획, 파일, 팀 및 작업 실행을 위한 프로젝트 워크스페이스.
- 강화된 거버넌스(governance), 승인, 감사(audit) 및 역할 기반 접근 제어(role-based access controls).
- 에이전트 실행(Agent runs), 워크플로우(workflows), 도구 및 컨텍스트 사용 전반에 걸친 더 깊은 추적 및 평가.
- 자체 호스팅 배포를 위한 모니터링, 보존(retention), 런타임 제어 및 프로덕션 강화.
<a href="https://github.com/xpert-ai/xpert/graphs/contributors">
<img src="https://contributors-img.web.app/image?repo=xpert-ai/xpert" alt="Xpert AI 기여자들">
</a>
Xpert가 유용하다면, 레포지토리에 별점을 주시는 것을 고려해 주세요.
라이선스 (License)
Xpert AI Platform Community Edition은 GNU Affero General Public License v3.0에 따라 라이선스가 부여됩니다. 소규모 비즈니스 및 엔터프라이즈 상업용 라이선스도 이용 가능합니다. 전체 약관은 LICENSES.md를 참조하세요.
