diff --git a/README.md b/README.md index 2c3be36e..2922be2c 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ ![Product fee](https://img.shields.io/badge/pricing-free-blue.svg?labelColor=%20%239b8afb&color=%20%237a5af8) [![Discussion posts](https://img.shields.io/github/discussions/TEN-framework/ten-agent?labelColor=%20%23FDB062&color=%20%23f79009)](https://github.com/TEN-framework/ten-agent/discussions/) [![Commits](https://img.shields.io/github/commit-activity/m/TEN-framework/ten-agent?labelColor=%20%237d89b0&color=%20%235d6b98)](https://github.com/TEN-framework/ten-agent/graphs/commit-activity) -[![Issues closed](https://img.shields.io/github/issues-search?query=repo%3ATEN-framework%2Fastra.ai%20is%3Aclosed&label=issues%20closed&labelColor=green&color=green)](https://github.com/TEN-framework/ten-agent/issues) +[![Issues closed](https://img.shields.io/github/issues-search?query=repo%3ATEN-framework%2Ften-agent%20is%3Aclosed&label=issues%20closed&labelColor=green&color=green)](https://github.com/TEN-framework/ten-agent/issues) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ten-agent/pulls) [![GitHub license](https://img.shields.io/badge/License-Apache_2.0-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ten-agent/blob/main/LICENSE) diff --git a/docs/readmes/README-JP.md b/docs/readmes/README-JP.md index a4b3a216..c44b9649 100644 --- a/docs/readmes/README-JP.md +++ b/docs/readmes/README-JP.md @@ -1,163 +1,194 @@ -![Astra banner image](https://github.com/TEN-framework/docs/blob/main/assets/jpg/astra_banner.jpg?raw=true) +![TEN Agent banner](https://github.com/TEN-framework/docs/blob/main/assets/jpg/banner.jpg?raw=true) +
-[![Follow on X](https://img.shields.io/twitter/follow/AstraAIAgent?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=AstraAIAgent) +[![Follow on X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=TenFramework) ![Product fee](https://img.shields.io/badge/pricing-free-blue.svg?labelColor=%20%239b8afb&color=%20%237a5af8) -[![Discussion posts](https://img.shields.io/github/discussions/TEN-framework/astra.ai?labelColor=%20%23FDB062&color=%20%23f79009)](https://github.com/TEN-framework/astra.ai/discussions/) -[![Commits](https://img.shields.io/github/commit-activity/m/TEN-framework/astra.ai?labelColor=%20%237d89b0&color=%20%235d6b98)](https://github.com/TEN-framework/astra.ai/graphs/commit-activity) -[![Issues closed](https://img.shields.io/github/issues-search?query=repo%3ATEN-framework%2Fastra.ai%20is%3Aclosed&label=issues%20closed&labelColor=green&color=green)](https://github.com/TEN-framework/ASTRA.ai/issues) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ASTRA.ai/pulls) -[![GitHub license](https://img.shields.io/badge/License-Apache_2.0-blue.svg?labelColor=%20%239b8afb&color=%20%237a5af8)](https://github.com/TEN-framework/ASTRA.ai/blob/main/LICENSE) -[![WeChat](https://img.shields.io/badge/WeChat-WeChat_Group-%2307C160?logo=wechat)](https://github.com/TEN-framework/ASTRA.ai/discussions/170) - -[![Discord](https://dcbadge.vercel.app/api/server/VnPftUzAMJ)](https://discord.gg/VnPftUzAMJ) - -[![GitHub watchers](https://img.shields.io/github/watchers/TEN-framework/astra.ai?style=social&label=Watch)](https://GitHub.com/TEN-framework/astra.ai/watchers/?WT.mc_id=academic-105485-koreyst) -[![GitHub forks](https://img.shields.io/github/forks/TEN-framework/astra.ai?style=social&label=Fork)](https://GitHub.com/TEN-framework/astra.ai/network/?WT.mc_id=academic-105485-koreyst) -[![GitHub stars](https://img.shields.io/github/stars/TEN-framework/astra.ai?style=social&label=Star)](https://GitHub.com/TEN-framework/astra.ai/stargazers/?WT.mc_id=academic-105485-koreyst) - -README in English -简体中文操作指南 -日本語のREADME -README in 한국어 -README en Español -README en Français -README in Italiano +[![Discussion posts](https://img.shields.io/github/discussions/TEN-framework/ten-agent?labelColor=%20%23FDB062&color=%20%23f79009)](https://github.com/TEN-framework/ten-agent/discussions/) +[![Commits](https://img.shields.io/github/commit-activity/m/TEN-framework/ten-agent?labelColor=%20%237d89b0&color=%20%235d6b98)](https://github.com/TEN-framework/ten-agent/graphs/commit-activity) +[![Issues closed](https://img.shields.io/github/issues-search?query=repo%3ATEN-framework%2Ften-agent%20is%3Aclosed&label=issues%20closed&labelColor=green&color=green)](https://github.com/TEN-framework/ten-agent/issues) +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ten-agent/pulls) +[![GitHub license](https://img.shields.io/badge/License-Apache_2.0-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ten-agent/blob/main/LICENSE) + +[![Discord TEN Community](https://dcbadge.vercel.app/api/server/VnPftUzAMJ)](https://discord.gg/VnPftUzAMJ) + +[![GitHub watchers](https://img.shields.io/github/watchers/TEN-framework/ten-agent?style=social&label=Watch)](https://GitHub.com/TEN-framework/ten-agent/watchers/?WT.mc_id=academic-105485-koreyst) +[![GitHub forks](https://img.shields.io/github/forks/TEN-framework/ten-agent?style=social&label=Fork)](https://GitHub.com/TEN-framework/ten-agent/network/?WT.mc_id=academic-105485-koreyst) +[![GitHub stars](https://img.shields.io/github/stars/TEN-framework/ten-agent?style=social&label=Star)](https://GitHub.com/TEN-framework/ten-agent/stargazers/?WT.mc_id=academic-105485-koreyst) + +README in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano + +[Getting Started](https://doc.theten.ai/ten-agent/getting_started) +  •   +[Create Extensions](https://doc.theten.ai/ten-agent/create_a_hello_world_extension) +  •   +[TEN Framework Repository](https://github.com/TEN-framework/ten_framework) + +
-
+**TEN Agent**は、世界初のリアルタイムマルチモーダルフレームワークによって駆動されています。オープンソースで、話す、見る、知識ベースにアクセスする能力を持っています。TEN Frameworkを活用することで、TEN Agentは以下の特徴を持っています: -[ドキュメント](https://astra-9.gitbook.io/ten-platform) -  •   -[クイックスタート](https://doc.theten.ai/getting-started/quickstart) -  •   -[チュートリアル](https://doc.theten.ai/getting-started/create-a-hello-world-extension) +1. **高性能リアルタイムマルチモーダル相互作用**: +複雑な音声-視覚AIアプリケーションに対して、高性能で低遅延のソリューションを提供します。 +2. **多言語およびマルチプラットフォームサポート**: +C++、Go、Pythonなどでの拡張機能開発をサポートします。Windows、Mac、Linux、モバイルデバイスで動作します。 -
+3. **エッジ-クラウド統合**: +エッジとクラウドにデプロイされた拡張機能を柔軟に組み合わせ、プライバシー、コスト、パフォーマンスのバランスを取ります。 + +4. **モデルの制限を超える柔軟性**: +シンプルなドラッグアンドドロッププログラミングを通じて、音声-視覚ツール、データベース、RAGなどを統合し、複雑なAIアプリケーションを簡単に構築できます。 + +5. **リアルタイムエージェント状態管理**: +動的な応答性のために、エージェントの動作をリアルタイムで管理および調整します。
+

Stay Tuned

+ +始める前に、必ずリポジトリをスターし、すべての新しいリリースについての通知を即座に受け取るようにしてください! -## Astra 音声エージェント +![TEN star us gif](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_us_2.gif?raw=true) -[Astra voice agent](https://theastra.ai) は、TEN を使用して構築された音声エージェントであり、マルチモーダルで低遅延の能力を示しています。 +
+

TEN Agent

+ +[TEN Agent](https://agent.theten.ai) -[![Showcase Astra voice agent](https://github.com/TEN-framework/docs/blob/main/assets/gif/astra_voice_agent.gif?raw=true)](https://theastra.ai) +TEN Agentは、[ TEN ](https://theten.ai)によって駆動されるマルチモーダルエージェントで、ローカルドキュメントのRAGからの理解力、話す、見る、推論力を示しています。 +[![Showcase TEN multimodal agent](https://github.com/TEN-framework/docs/blob/main/assets/gif/features.gif?raw=true)](https://agent.theten.ai)
-

グラフデザイナーを使用して音声エージェントを構成する方法

+

TEN Agentをローカルでビルドする方法

### 前提条件 + #### キー -- Agora App ID と App Certificate([詳細はこちら](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web)) -- Azure の [STT](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) と [TTS](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) API キー -- [OpenAI](https://openai.com/index/openai-api/) API キー -#### インストール -- [Docker](https://www.docker.com/) と [Docker Compose](https://docs.docker.com/compose/install/) -- [Node.js(LTS) v18](https://nodejs.org/en) -#### システム要件 -- CPU >= 2 コア -- RAM >= 4 GB +- Agora [ App ID ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) と [ App Certificate ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project)(証明書は必須ではありません) +- Azure [SST](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) と [TTS](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) APIキー(他のプロバイダーを使用しても構いません) +- [OpenAI](https://openai.com/index/openai-api/) APIキー -#### Apple Silicon 上の Docker 設定 -Apple Silicon Mac を使用している場合は、Docker の "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" オプションのチェックを外す必要があります。そうしないと、サーバーが正常に動作しません。 +#### インストール + - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) + - [Node.js(LTS) v18](https://nodejs.org/en) -
+#### 最小システム要件 + - CPU >= 2コア + - RAM >= 4 GB -![Docker Setting](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true) +#### Apple SiliconでのDocker設定 +Apple Siliconを使用している場合、Dockerの「Use Rosetta for x86_64/amd64 emulation on Apple Silicon」オプションのチェックを外す必要があります。そうしないとサーバーが動作しません。 -
+![Docker設定](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true) ### 次のステップ -#### 1. 設定ファイルの準備 -プロジェクトのルートで、`cp` コマンドを使って、サンプルから `.env` を作成してください。 + +#### 1. 設定ファイルの変更 +プロジェクトのルートで、`cp`コマンドを使用して`.env`ファイルを例から作成します。 + +これは後で`docker compose`の情報を保存するために使用されます。 ```bash cp ./.env.example ./.env ``` -#### 2. キーのバインド -`.env` ファイルを開き、対応するキーをバインドします。ここで異なるキーを設定することで、異なるエージェントを選択できます: -``` -# Agora App ID と Agora App Certificate +#### 2. APIキーの設定 +`.env`ファイルを開き、`keys`と`regions`を入力します。ここで異なる`extensions`を使用するかどうかも選択できます: +```bash +# Agora App IDとAgora App Certificate AGORA_APP_ID= +# Agoraアカウント内で証明書を有効にしていない限り、空のままにしてください。 AGORA_APP_CERTIFICATE= -# Extension: agora_rtc -# Azure STT キーとリージョン +# Azure STTキーとリージョン AZURE_STT_KEY= AZURE_STT_REGION= -# Extension: azure_tts -# Azure TTS キーとリージョン +# Azure TTSキーとリージョン AZURE_TTS_KEY= AZURE_TTS_REGION= -# Extension: openai_chatgpt -# OpenAI API キー +# OpenAI APIキー OPENAI_API_KEY= ``` -#### 3. Docker コンテナの起動 -同じディレクトリで、Docker イメージを使用して Docker コンテナを構築します: +#### 3. エージェント開発コンテナの起動 +同じディレクトリで、`docker compose up`コマンドを実行してコンテナを構成します: ```bash -# Docker コンテナの起動: docker compose up ``` -#### 4. エージェントのビルドとサーバーの起動 -別のターミナルウィンドウを開き、以下のコマンドを実行して Docker コンテナに入り、エージェントをビルドしてサーバーを起動します: +#### 4. コンテナに入りエージェントをビルド +別のターミナルウィンドウを開き、コンテナに入ってエージェントをビルドします: ```bash -# コンテナに入り、エージェントをビルド docker exec -it astra_agents_dev bash make build +``` -# ポート 8080 でサーバーを起動 +#### 5. サーバーの起動 +ビルドが完了したら、ポート`8080`で`make run-server`を実行します: +```bash make run-server ``` -### 完了 🎉 +### 完了と確認 🎉 -ここまででローカルでの構築が完了しました。簡単な 4 ステップで、エージェントの体験が最大化されます! +#### TEN Agent +ブラウザでhttp://localhost:3000を開き、TEN Agentをプレイしてテストします。 -#### Astra 音声エージェントの検証 +#### Graph Designer -ブラウザで `localhost:3000` を開いて音声エージェントを体験できます。 +別のタブを開いてhttp://localhost:3001にアクセスし、Graph Designerを使用してキャンバス上で -#### グラフデザイナーの検証 +
+

TEN Agentの比較

-別のタブを開いて `localhost:3001` にアクセスし、TEN グラフデザイナー (ベータ版) を体験できます。簡単なドラッグアンドドロップと動的なノード接続で、Astra 音声エージェントを簡単にカスタマイズできます。 +
-![TEN Graph Designer](https://github.com/TEN-framework/docs/blob/main/assets/gif/graph_designer.gif?raw=true) +| **機能** | **TEN Agent** | **Pipecat** | **LiveKit:KITT** | **Vapi.ai** | **DailyBots** | **Play.ai** | +|:----------------------------------------:|:-------:|:--------:|:-------------:|:----------------:|:----------------:|:----------------:| +| **視覚機能** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **多言語対応の高度なTTSサポート** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Go言語での拡張機能サポート** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **C++での拡張機能サポート** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **RAGサポート** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **拡張機能用ワークフロービルダー** | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | +| **豊富なLLMサポート** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Python言語での拡張機能サポート** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **オープンソース** | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | -
-

スターを付ける

+
-頻繁に更新されるため、最新情報を見逃さないように、リポジトリにスターを付けてください。 +
-![TEN star us gif](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_the_repo_confetti_higher_quality.gif?raw=true)

コミュニティに参加する

-- [Discord](https://discord.gg/VnPftUzAMJ):アプリケーションを共有し、コミュニティと交流するのに最適です。 -- [WeChat Group](https://github.com/TEN-framework/ASTRA.ai/discussions/170): WeChat グループのコミュニティが好きな方は、ぜひご参加ください。 -- [Github Discussion](https://github.com/TEN-framework/astra.ai/discussions):フィードバックを提供し、質問するのに最適です。 -- [GitHub Issues](https://github.com/TEN-framework/astra.ai/issues):バグを報告し、新機能を提案するのに最適です。詳細については、[貢献ガイドライン](./docs/code-of-conduct/contributing.md)をご覧ください。 -- [X(以前のTwitter)](https://img.shields.io/twitter/follow/AstraAIAgent?logo=X&color=%20%23f5f5f5):エージェントを共有し、コミュニティと交流するのに最適です。 +- [Discord](https://discord.gg/VnPftUzAMJ): アプリケーションの共有やコミュニティとの交流に最適です。 +- [GitHub Discussion](https://github.com/TEN-framework/ten-agent/discussions): フィードバックの提供や質問に最適です。 +- [GitHub Issues](https://github.com/TEN-framework/ten-agent/issues): バグの報告や新機能の提案に最適です。詳細は[貢献ガイドライン](./docs/code-of-conduct/contributing.md)を参照してください。 +- [X (旧Twitter)](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5): エージェントの共有やコミュニティとの交流に最適です。 -
+

コード貢献者

-[![ASTRA](https://contrib.rocks/image?repo=TEN-framework/astra.ai)](https://github.com/TEN-framework/astra.ai/graphs/contributors) +[![TEN](https://contrib.rocks/image?repo=TEN-framework/ten-agent)](https://github.com/TEN-framework/ten-agent/graphs/contributors)
-

貢献を歓迎します

+

貢献ガイドライン

-貢献を歓迎します!まずは [貢献ガイドライン](../code-of-conduct/contributing.md) をお読みください。 +貢献を歓迎します!まずは[貢献ガイドライン](./docs/code-of-conduct/contributing.md)をお読みください。

ライセンス

-このプロジェクトは Apache 2.0 ライセンスの下でライセンスされています。詳細については [LICENSE](LICENSE) をご覧ください。 +このプロジェクトはApache 2.0ライセンスの下でライセンスされています - 詳細は[LICENSE](LICENSE)ファイルをご覧ください。