
#### #### ## 소개 ### 🚀 **끝없는 가능성을 지닌 AI 데스크톱 컴패니언!** #### 데스크톱 컴패니언: 커스텀 VRM 모델, 액션, 3D 장면을 지원하며, [live2D 확장 기능](https://github.com/heshengtao/sap-live2d)과 호환됩니다.  #### Link VTS: Vtube Studio에서 Live2D 모델을 제어하며, 커스텀 액션 및 표정 제어를 지원합니다.  #### 높은 자유도의 채팅 인터페이스: 커스텀 배경 이미지, 이모지 팩, 캐릭터 페르소나, THA 기반 2D 캐릭터 아바타, 캐릭터 MCP 도구로 더욱 몰입감 있는 대화를 제공합니다.  #### 태스크 센터: AI 에이전트가 백그라운드에서 모든 고급 작업을 수행하고, 컴퓨터를 자동으로 제어하여 작업을 완료할 수 있도록 지원합니다. MCP 및 Agent Skills을 지원합니다.  #### 컴퓨터 제어: 데스크톱 비전과 마우스, 키보드, 터미널을 제어하는 도구 체인을 결합하여 AI 에이전트가 컴퓨터에서 모든 작업을 수행할 수 있습니다! 아래 이미지는 AI가 Wordle을 플레이하는 모습입니다.  #### 다양한 창 모드: 채팅 인터페이스는 스마트폰 크기 및 캡슐 크기로 데스크톱에 도킹 가능합니다.  #### 다중 역할 그룹 채팅: 선술집 캐릭터 카드와 장기 기억을 지원하여 여러 캐릭터와 동시에 채팅할 수 있습니다!  #### 인스턴트 메시징 봇: QQ, WeChat, Feishu, DingTalk, Telegram, Discord, Slack에 원클릭 배포를 지원합니다.  #### 라이브 스트리밍 봇: Bilibili, YouTube, Twitch에 원클릭 배포를 지원하며, 360도 파노라마 라이브 스트리밍이 가능합니다.  #### AI 브라우저: AI 에이전트에 자체 브라우저를 탑재하여 자동 제어를 지원합니다.  #### 확장 기능 시스템: 확장 기능 설치 및 새 확장 기능 생성을 지원합니다. 아래 이미지는 galgame 확장 기능입니다. 모든 확장 기능은 독립 창 또는 사이드바에서 열 수 있습니다. [sap-extension-creator](skills/sap-extension-creator) 에이전트 스킬을 사용하여 새 SAP 확장을 생성하고, 에이전트 파티의 부트스트래핑을 실현할 수도 있습니다!  #### 개발자 친화적: 개방형 OpenAI API 인터페이스와 MCP 인터페이스를 제공하여 에이전트를 외부에 연결할 수 있습니다.  ## 빠른 시작 ### CLI 에이전트인 경우 CLI 에이전트는 [README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md) 문서를 확인해야 합니다. 이 문서를 참고하여 사용자에게 이 소프트웨어 설치를 안내하세요! ### CLI 에이전트를 사용하는 인간인 경우 이 링크를 AI에게 보내면, AI가 이 소프트웨어 설치를 안내할 것입니다! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### Windows 휴대용 패키지 (권장! 설치 불필요 소스 버전, 최신 리포지토리로 원클릭 동기화 지원, 데스크톱 버전 패키징 대기 불필요) 👉 [다운로드](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-win-v0.4.2.zip) ⭐ 참고! `一键更新(update).bat`를 더블 클릭하여 소프트웨어를 업데이트하거나, `一键启动(start).bat`를 더블 클릭하여 소프트웨어를 시작할 수 있습니다. 운영 체제는 **Windows 10/11, Windows Server 2025** 이상이어야 합니다! ### Windows 데스크톱 설치 👉 [다운로드](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) ⭐ 참고! 설치 시 현재 사용자에 대해서만 설치를 선택하세요. 그렇지 않으면 시작 시 관리자 권한이 필요합니다. 운영 체제는 **Windows 10/11, Windows Server 2025** 이상이어야 합니다! ### MacOS 통합 패키지 (현재 M 칩만 지원, 설치 불필요 소스 코드 버전, 최신 리포지토리로 원클릭 동기화 지원, 데스크톱 버전 패키징 대기 불필요) > **개발자/고급 사용자 대상**: 설치 불필요 소스 코드 버전, 최신 리포지토리로 원클릭 동기화 지원, 데스크톱 버전 패키징 대기 불필요. 👉 [다운로드](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-mac-v0.4.2.zip) #### 🚀 사용 방법 **1. 네트워크 다운로드 격리 제거 (중요)** 다운로드 및 압축 해제 후, 터미널을 열고 다음 명령어를 입력한 후 (끝에 공백이 있음에 주의), **압축 해제된 폴더**를 터미널 창으로 드래그한 다음 Enter 키를 누르세요: ```shell sudo xattr -rd com.apple.quarantine ``` *(참고: `-rd` 매개변수는 폴더 내 모든 구성 요소의 격리 속성을 재귀적으로 제거합니다. 그렇지 않으면 Python 환경이 정상적으로 작동하지 않을 수 있습니다.)* **2. 스크립트 실행 권한 부여** 터미널에서 해당 폴더로 이동하여 다음을 실행하세요: ```shell chmod +x 一键更新(update).sh 一键启动(start).sh ``` **3. 소프트웨어 실행** - **처음 사용/업데이트:** 먼저 `./一键更新(update).sh`를 실행하여 종속성이 최신 버전으로 동기화되었는지 확인하는 것이 좋습니다. - **일상적인 시작:** 직접 `./一键启动(start).sh`를 실행하세요. ### MacOS 데스크톱 설치 (현재 M 칩만 지원) 👉 [다운로드](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐ 주의! 다운로드 후, dmg 파일의 앱을 `/Applications` 디렉토리로 드래그한 다음, 터미널을 열고 다음 명령어를 실행하여 루트 비밀번호를 입력하면 네트워크 다운로드에 부여된 Quarantine 속성이 제거됩니다: ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### Linux 데스크톱 설치 `.AppImage`는 설치가 필요 없으며 즉시 사용할 수 있는 Linux 애플리케이션 형식입니다. 대부분의 Linux 배포판에 적합합니다. 👉 [Linux-AppImage-X86_64](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Linux-x86_64.AppImage) 👉 [Linux-AppImage-Arm64](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Linux-arm64.AppImage) ### Docker 배포 (이 버전의 데스크톱 펫은 브라우저를 통해서만 볼 수 있습니다.) ```shell docker pull ailm32442/super-agent-party:latest docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest ``` ⭐ 참고! `./super-agent-data`는 원하는 로컬 폴더로 대체할 수 있습니다. Docker 시작 후 모든 데이터는 이 로컬 폴더에 캐시되며, 어디에도 업로드되지 않습니다. **즉시 사용 가능:** http://localhost:3456/ 방문 --- ### Docker Compose 배포 (이 버전의 데스크톱 펫은 브라우저를 통해서만 볼 수 있으며, 로그인 관리를 위한 추가 게이트웨이 컨테이너가 시작됩니다.) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d ``` ⭐ 참고! 기본 사용자 이름은 `root`, 기본 비밀번호는 `pass`입니다. 첫 로그인 후 비밀번호를 변경하세요. **즉시 사용 가능:** http://localhost:3456/ 방문 **API 키 관리:** http://localhost:3456/token.html 방문 ### Docker 버전과 함께 사용하는 Lite 클라이언트 (Docker를 데스크톱 앱으로 전환) 👉 [SAP-lite-Windows-exe](https://github.com/heshengtao/desktop-for-sap/releases/download/v0.1.2/super-agent-party-lite-Setup-0.1.2.exe) 👉 [SAP-lite-MacOS-dmg](https://github.com/heshengtao/desktop-for-sap/releases/download/v0.1.2/super-agent-party-lite-0.1.2-Mac.dmg) ### 소스 코드 배포 ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev ``` ## 확장 기능 완전히 새로운 확장 기능 시스템이 추가되었습니다. [플러그인 목록](https://super-agent-party.github.io/plugins.html)에서 사용 가능한 플러그인을 확인하거나, Party 내에서 【개발자】→【확장 기능】에서 직접 확인 및 설치할 수 있습니다. 또한 [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io)에서 직접 개발한 확장 기능을 공식 플러그인 목록에 추가할 수 있습니다! ### 기존 확장 기능 | 이름 | 작성자 | 설명 | 저장소 URL | |-----------------------|-------------------|--------------------------------------------------------------------|--------------------------------------------------| | Super Agent Party Example | heshengtao | Super Agent Party의 예제 플러그인으로, 플러그인 아키텍처와 기능을 보여줍니다. | https://github.com/heshengtao/sap-example | | Super Agent Party Example With NodeJS | heshengtao | NodeJS 환경을 사용한 채팅 프론트엔드 예제입니다. | https://github.com/heshengtao/sap-example-with-node | | Web Preview | heshengtao | Super Agent Party에 웹 미리보기 기능을 제공하는 플러그인입니다. | https://github.com/heshengtao/sap-web-preview | | Story Adventure | heshengtao | AI를 사용하여 스토리 콘텐츠와 선택지를 생성하는 인터랙티브 스토리 어드벤처 플러그인입니다. | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | Live 2D 확장 기능입니다. | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | AI 편집기입니다. | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | AI 갈게임 확장 기능입니다. | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | AI 타로 리더 확장 기능입니다. | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | AI 시트 확장 기능입니다. | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | AI drawio 확장 기능입니다. | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | AI mermaid 편집기 확장 기능입니다. | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | Super Agent Party용 AI RSS 리더 확장 기능입니다. | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | Super Agent Party를 원클릭으로 공개 인터넷에 노출합니다. | https://github.com/heshengtao/sap-remote | | Code Server | heshengtao | Super Agent Party용 IDE 확장 기능입니다. | https://github.com/heshengtao/sap-code-server | | CLI | heshengtao | Super Agent Party용 CLI 확장 기능입니다. | https://github.com/heshengtao/sap-cli | | LX-music | heshengtao | Super Agent Party를 LX Music API에 연결하여 AI 컴패니언이 음악 재생을 제어할 수 있게 합니다! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | Super Agent Party용 AI PPT 확장 기능입니다. | https://github.com/heshengtao/sap-ai-ppt | | Lyra 星莱 | heshengtao | 별빛 마법사 캐릭터 확장 — 캐릭터 카드, THA 모델, 스티커 및 배경을 원클릭으로 설치합니다. | https://github.com/heshengtao/sap-lyra-extension | ## 하드웨어 요구 사항 - CPU: 2코어 이상 - 메모리: 2GB 이상 **모든 모델은 선택 사항이며, 로컬 배포 엔진에 접속하거나 전부 클라우드 서비스 제공자 인터페이스를 사용할 수 있으므로 하드웨어 요구 사항이 거의 없습니다. 2코어 2GB 클라우드 서버에서 Docker 버전을 테스트했으며, 정상적으로 작동하는 것을 확인했습니다.** ## 사용 방법 - 데스크톱: 데스크톱 아이콘을 클릭하여 즉시 사용할 수 있습니다. - 웹 또는 Docker: 시작 후 http://localhost:3456/ 에 접속하세요. - API 호출: 개발자 친화적이며, OpenAI 형식과 완벽하게 호환됩니다. 실시간으로 출력 가능하며, 원본 API의 응답 속도에 영향을 주지 않습니다. 호출 코드를 수정할 필요가 없습니다: ```python from openai import OpenAI client = OpenAI( api_key="super-secret-key", base_url="http://localhost:3456/v1" ) response = client.chat.completions.create( model="super-model", messages=[ {"role": "user", "content": "Super Agent Party란 무엇인가요?"} ] ) print(response.choices[0].message.content) ``` - MCP 호출: 시작 후 설정 파일에 다음 내용을 작성하여 로컬 MCP 서비스를 호출할 수 있습니다: ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp" } } } ``` - 단축 명령어: 채팅 입력창 또는 연결된 IM 플랫폼(Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk)에서 아래 명령어를 입력하여 어시스턴트를 빠르게 제어할 수 있습니다. **시스템 설정 → 단축 명령어**에서 활성화/비활성화 및 전체 목록을 확인할 수 있습니다. | 명령어 | 별칭 | 범위 | 설명 | | --- | --- | --- | --- | | `/help` | `/帮助` `/?` | 채팅 + IM | 사용 가능한 모든 단축 명령어 목록 표시 | | `/new` | `/reset` `/重启` `/新建` `/restart` | 채팅 + IM | 현재 대화를 지우고 새로 시작 | | `/stop` | `/停止` | 채팅 + IM | 현재 생성 중인 응답 중지 | | `/retry` | `/重试` | 채팅 전용 | 마지막 응답 다시 생성 | | `/model [provider:model]` | `/模型` | 채팅 + IM | 모델 표시 또는 전환 (IM에서는 표시만) | | `/personality [name]` | `/角色` `/persona` | 채팅 + IM | 페르소나 표시 또는 전환 | | `/skills` | `/技能` | 채팅 + IM | 사용 가능한 스킬 목록 보기 | | `/id` | - | IM 전용 | 현재 세션/채널 ChatID 표시 | | `/sub` | `/订阅` | IM 전용 | 현재 세션을 프로액티브 메시지 목록에 추가 | | `/unsub` | `/取消订阅` | IM 전용 | 현재 세션을 프로액티브 메시지 목록에서 제거 | | `/plan` * | `/计划` | 채팅 + IM | 플랜 모드(읽기 전용)로 전환 | | `/read` * | `/只读` | 채팅 + IM | 읽기 전용 모드로 전환 (각 작업 확인 필요) | | `/edit` * | `/编辑` | 채팅 + IM | 편집 허용 모드로 전환 | | `/yolo` * | - | 채팅 + IM | Yolo 모드(완전 자율)로 전환 | | `/cowork` * | `/协作` | 채팅 + IM | 협업 모드(하위 에이전트 협업)로 전환 | | `/goal` * | `/目标` | 채팅 + IM | 목표 모드(자율 루프)로 전환 | | `/