
#### #### ## はじめに ### 🚀 **無限の可能性を秘めた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をプレイしている様子です。  #### 複数のウィンドウモード:チャットインターフェースはスマートフォンサイズやカプセルサイズでデスクトップにドッキング可能  #### マルチロールグループチャット:タバーンキャラクターカードと長期記憶に対応し、複数のキャラクターと同時にチャットできます!  #### インスタントメッセージングBot:QQ、WeChat、Feishu、DingTalk、Telegram、Discord、Slackへのワンクリックデプロイに対応  #### ライブ配信Bot:Bilibili、YouTube、Twitchへのワンクリックデプロイに対応し、360度パノラマライブ配信も可能。  #### AIブラウザ:AIエージェントに専用ブラウザを装備し、自動制御に対応  #### 拡張機能システム:拡張機能のインストールと新規作成に対応。下の画像はギャルゲー拡張機能です。すべての拡張機能は独立ウィンドウまたはサイドバーで開くことができます。あなたは[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` をダブルクリックしてソフトウェアを起動できます。OSは **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) ⭐ 注意! インストール時に「現在のユーザーのみにインストール」を選択してください。そうしないと、起動時に管理者権限が必要になります。OSは **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デスクトップインストール 👉 [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デプロイ(このバージョンのデスクトップペットはブラウザからのみ閲覧できます。) - 2つのコマンドでインストール: ```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にWebプレビュー機能を追加するプラグイン。 | 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版をテストし、問題なく動作することを確認しています。** ## 使い方 - デスクトップ:デスクトップアイコンをクリックするだけで使用できます。 - Webまたは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 | ゴールモード(完了まで自律実行)に切り替え | | `/