heshengtao/super-agent-party

Super Agent Party – AI 기반 데스크톱 컴패니언

이것이 무엇인가

• 대규모 언어 모델 에이전트가 시각적 아바타(VRM 3D 모델 또는 Live2D THA 헤드)를 통해 사용자와 상호작용할 수 있게 해주는 크로스 플랫폼 데스크톱 애플리케이션입니다.
• 에이전트는 컴퓨터(마우스, 키보드, 터미널)를 제어하고, 웹을 탐색하며, 다양한 IM 플랫폼에서 메시지를 보내고, 라이브 비디오를 스트리밍할 수도 있습니다.
• Windows, macOS(M-칩), Linux AppImage, Docker 이미지 및 개발자용 소스 코드 버전으로 바로 실행 가능한 바이너리로 제공됩니다.

주요 기능

기능	제공 사항
사용자 지정 아바타	모든 VRM 3D 모델 또는 Live2D THA 헤드를 로드하고, 동작, 표정 및 음성을 정의합니다.
컴퓨터 비전 및 제어	에이전트가 화면을 보고, UI 요소를 인식하며, 마우스/키보드 명령을 실행할 수 있습니다(예: Wordle 플레이).
멀티 윈도우 채팅 UI	폰 크기, 캡슐 독 또는 전체 화면 창; 사용자 지정 배경, 이모지 팩, 페르소나 카드.
그룹 채팅 및 메모리	각각 장기 메모리와 "선술집" 카드를 가진 여러 캐릭터와 동시에 대화합니다.
작업 센터 및 스킬	에이전트가 복잡한 백그라운드 작업을 수행할 수 있게 해주는 재사용 가능한 스킬(MCP 확장)을 정의합니다.
인스턴트 메신저 봇	QQ, WeChat, Feishu, DingTalk, Telegram, Discord, Slack에 원클릭 배포.
라이브 스트리밍 봇	Bilibili, YouTube, Twitch에 아바타를 스트리밍하며, 선택적 360° 파노라마 모드 지원.
AI 기반 브라우저	에이전트가 자동으로 탐색하고 제어할 수 있는 내장 브라우저.
확장 시스템	플러그인 설치 또는 생성(예: 스토리 어드벤처, AI 편집기, 갈게임, RSS 리더, 코드 서버).
OpenAI 호환 API	공식 OpenAI Python 클라이언트와 호환되는 로컬 /v1 엔드포인트를 노출하여 기존 코드가 로컬 에이전트와 통신할 수 있게 합니다.
MCP 인터페이스	다른 도구가 에이전트의 작업을 호출할 수 있는 Machine-Control-Protocol 엔드포인트.

획득 방법

• Windows: 휴대용 zip(설치 불필요) 또는 설치 프로그램(.exe).
• macOS(M-칩): 휴대용 zip 또는 서명된 .dmg 번들.
• Linux: x86_64 또는 arm64용 AppImage.
• Docker: ailm32442/super-agent-party(또는 Alibaba Cloud 미러)를 풀하고 데이터 폴더를 마운트하여 실행; 브라우저 전용 UI는 http://localhost:3456에서 제공됩니다.
• 소스 코드: git clone … && uv sync && npm install && npm run dev 코드를 수정하려는 개발자용.

첫 실행 설정

1. 필요한 경우 macOS 격리(xattr)를 제거합니다.
2. 헬퍼 스크립트를 실행 가능하게 만듭니다(chmod +x 一键更新(update).sh 一键启动(start).sh).
3. 업데이트 스크립트를 실행하여 최신 모델과 종속성을 가져온 다음 앱을 시작합니다.

일반적인 워크플로우

• 개인 비서 – 3D 아바타와 대화하고, 회의 일정을 잡거나, 웹을 탐색하거나, PC를 제어하도록 요청합니다.
• 콘텐츠 크리에이터 – 라이브 스트리밍 봇을 사용하여 AI가 내레이션하는 동안 YouTube/Twitch에서 토킹 헤드 아바타를 방송합니다.
• 개발자 – 자신의 코드에서 로컬 OpenAI 호환 엔드포인트를 호출하거나 사용자 지정 확장 프로그램을 작성합니다(플러그인은 내장 마켓플레이스에 나열됨).
• 팀 협업 – 서버에 Docker 버전을 배포하고, UI를 팀원에게 공개하며, AI가 Slack 또는 Discord에서 공유 "어시스턴트" 역할을 하게 합니다.

하드웨어 요구 사항

• 최소: CPU 2코어, 2GB RAM.
• 모든 AI 모델은 선택 사항입니다. 앱을 로컬 추론 엔진(예: Ollama) 또는 클라우드 제공자에 연결하여 리소스 사용량을 낮게 유지할 수 있습니다.

제한 사항 / 주의 사항

• 데스크톱 UI는 현재 Windows 10/11, macOS M-칩 및 Linux AppImage에서만 실행됩니다. 이전 OS 버전은 지원되지 않을 수 있습니다.
• 전체 컴퓨터 제어 기능(/yolo, /cowork 등)은 CLI 에이전트 구성 요소와 적절한 권한이 필요합니다.
• 일부 통합(VTS, 특정 IM 플랫폼)은 별도로 설치해야 하는 타사 소프트웨어에 의존합니다.
• Docker 변형은 브라우저 전용 보기를 제공합니다. 네이티브 데스크톱 펫 경험은 네이티브 바이너리가 필요합니다.

더 알아보기

• 공식 웹사이트: https://www.agentparty.top/
• 문서: README에 링크된 중국어 가이드(Feishu) 및 영어 가이드(Notion).
• Bilibili 및 YouTube의 커뮤니티 튜토리얼(배지 바의 링크).
• 플러그인 마켓플레이스: https://super-agent-party.github.io/plugins.html

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 외부 가정은 추가되지 않았습니다.