From 653ea826abdd14d691a41f2d74ee3c6461ff27e5 Mon Sep 17 00:00:00 2001 From: Elliott Chen Date: Mon, 19 Aug 2024 18:25:34 +0800 Subject: [PATCH 1/5] Update documentation links to point to the new TEN platform documentation --- README.md | 48 +++++++++++++++++++-------------------- docs/readmes/README-CN.md | 2 +- 2 files changed, 24 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index b7e68c4b..f95f2757 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@
[![Follow on X](https://img.shields.io/twitter/follow/ten_platform?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=ten_platform) +![Price is free](https://img.shields.io/badge/free-pricing?logo=free&color=%20%23155EEF&label=pricing&labelColor=%20%23528bff) [![Discussion posts](https://img.shields.io/github/discussions/rte-design/astra.ai?labelColor=%20%23FDB062&color=%20%23f79009)](https://github.com/rte-design/astra.ai/discussions/) [![Commits](https://img.shields.io/github/commit-activity/m/rte-design/astra.ai?labelColor=%20%237d89b0&color=%20%235d6b98)](https://github.com/rte-design/astra.ai/graphs/commit-activity) [![Issues closed](https://img.shields.io/github/issues-search?query=repo%3Arte-design%2Fastra.ai%20is%3Aclosed&label=issues%20closed&labelColor=green&color=green)](https://github.com/rte-design/ASTRA.ai/issues) @@ -17,7 +18,7 @@ 简体中文 日本語 -[Documentation](https://astra-9.gitbook.io/ten-platform) +[Documentation](https://doc.theten.ai)   •   [Getting Started](https://astra-9.gitbook.io/ten-platform/getting-started/quickstart)   •   @@ -26,15 +27,15 @@

-

Voice agent: Astra

+

Astra AI agent

-[Voice agent: Astra](https://theastra.ai) +[Astra AI agent](https://theastra.ai) -Astra is a voice agent, powered by TEN, demonstrating its ability to create intuitive and seamless conversational interactions. +Astra is a multimodal AI agent powered by [ TEN ](https://doc.theten.ai), demonstrating its capabilities in speech, vision, and reasoning through RAG from local documentation. [![Showcase Astra](https://github.com/rte-design/docs/blob/main/assets/gifs/astra-voice-agent.gif?raw=true)](https://theastra.ai)
-

How to build voice agent locally +

How to build Astra locally ### Prerequisites @@ -59,71 +60,68 @@ You will need to uncheck "Use Rosetta for x86_64/amd64 emulation on Apple Silico ### Next step #### 1. Modify config files -In the root of the project, create these files from the examples. They will be used to store information for Docker Compose later. +In the root of the project, use the following command to create `.env` and `./agents/property.json` from the examples. + +They will be used to store information for `docker compose` later. ```bash -# Create .env from the example cp ./.env.example ./.env - -# Create property.json from the example cp ./agents/property.json.example ./agents/property.json ``` #### 2. Setup API keys -Open the `.env` file and fill in the keys and regions. This is also where you can choose to use any different extensions: -``` +Open the `.env` file and fill in the `keys` and `regions`. This is also where you can choose to use any different `extensions`: +```bash # Agora App ID and Agora App Certificate -# required: this variable must be set AGORA_APP_ID= -AGORA_APP_CERTIFICATE= +# Leave empty unless you have enabled the certificate +AGORA_APP_CERTIFICATE= "" -# Extension: agora_rtc # Azure STT key and region AZURE_STT_KEY= AZURE_STT_REGION= -# Extension: azure_tts # Azure TTS key and region AZURE_TTS_KEY= AZURE_TTS_REGION= -# Extension: openai_chatgpt # OpenAI API key OPENAI_API_KEY= ``` #### 3. Start agent development containers -In the same directory, run the `docker` command to compose containers: +In the same directory, run the `docker compose up` command to compose containers: ```bash -# Execute docker compose up to start the services docker compose up ``` -#### 4. Build agent and start server -Open up a separate terminal window, build the agent and start the server: +#### 4. Enter container and build agent +Open up a separate terminal window, enter the container and build the agent: ```bash -# Enter container to build agent docker exec -it astra_agents_dev bash make build +``` -# Once the build is done, run server on port 8080 +#### 5. Start the server +Once the build is done, `make run-server` on port `8080`: +```bash make run-server ``` ### Finish and verify 🎉 #### Astra voice agent -Open up localhost:3000 in browser to test Astra voice agent. +Open up http://localhost:3000 in browser to test Astra voice agent. #### Graph designer -Open up another tab go to localhost:3001, and use graph designer to edit the flow and properties of any extensions. +Open up another tab go to http://localhost:3001, and use graph designer to edit the flow and properties of any extensions. ![TEN Graph Designer](https://github.com/rte-design/docs/blob/main/assets/gifs/graph-designer.gif?raw=true)

TEN Platform

-Now that you’ve created your first AI agent, the creativity doesn't stop here. To develop more amazing agents, you’ll need an advanced understanding of how the TEN service works under the hood. Please refer to the [ TEN platform documentation ](https://astra-9.gitbook.io/ten-platform). +Now that you’ve created your first AI agent, the creativity doesn't stop here. To develop more amazing agents, you’ll need an advanced understanding of how the TEN service works under the hood. Please refer to the [ TEN platform documentation ](https://doc.theten.ai).

Stay Tuned

diff --git a/docs/readmes/README-CN.md b/docs/readmes/README-CN.md index 6c949cd9..2e11bd83 100644 --- a/docs/readmes/README-CN.md +++ b/docs/readmes/README-CN.md @@ -21,7 +21,7 @@
-[文档](https://astra-9.gitbook.io/ten-platform) +[文档](https://doc.theten.ai)   •   [快速开始](https://astra-9.gitbook.io/ten-platform/getting-started/quickstart)   •   From 4809092888160d7218fbc9863c103ef668f619e2 Mon Sep 17 00:00:00 2001 From: Elliott Chen Date: Tue, 20 Aug 2024 16:22:43 +0800 Subject: [PATCH 2/5] Update readme and wording --- README.md | 84 +++++++++++++++++-- .../src/platform/pc/description/index.tsx | 2 +- 2 files changed, 77 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index f95f2757..af977508 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,12 @@
[![Follow on X](https://img.shields.io/twitter/follow/ten_platform?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=ten_platform) -![Price is free](https://img.shields.io/badge/free-pricing?logo=free&color=%20%23155EEF&label=pricing&labelColor=%20%23528bff) +![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/rte-design/astra.ai?labelColor=%20%23FDB062&color=%20%23f79009)](https://github.com/rte-design/astra.ai/discussions/) [![Commits](https://img.shields.io/github/commit-activity/m/rte-design/astra.ai?labelColor=%20%237d89b0&color=%20%235d6b98)](https://github.com/rte-design/astra.ai/graphs/commit-activity) [![Issues closed](https://img.shields.io/github/issues-search?query=repo%3Arte-design%2Fastra.ai%20is%3Aclosed&label=issues%20closed&labelColor=green&color=green)](https://github.com/rte-design/ASTRA.ai/issues) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/rte-design/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/rte-design/ASTRA.ai/blob/main/LICENSE) +[![GitHub license](https://img.shields.io/badge/License-Apache_2.0-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff)](https://github.com/rte-design/ASTRA.ai/blob/main/LICENSE) [![Discord TEN Community](https://dcbadge.vercel.app/api/server/VnPftUzAMJ)](https://discord.gg/VnPftUzAMJ) @@ -27,13 +27,13 @@

-

Astra AI agent

+

Astra - a multimodal agent

-[Astra AI agent](https://theastra.ai) +[Astra multimodal agent](https://theastra.ai) -Astra is a multimodal AI agent powered by [ TEN ](https://doc.theten.ai), demonstrating its capabilities in speech, vision, and reasoning through RAG from local documentation. +Astra is a multimodal agent powered by [ TEN ](https://doc.theten.ai), demonstrating its capabilities in speech, vision, and reasoning through RAG from local documentation. -[![Showcase Astra](https://github.com/rte-design/docs/blob/main/assets/gifs/astra-voice-agent.gif?raw=true)](https://theastra.ai) +[![Showcase Astra multimodal agent](https://github.com/rte-design/docs/blob/main/assets/gifs/astra-voice-agent.gif?raw=true)](https://theastra.ai)

How to build Astra locally @@ -109,8 +109,8 @@ make run-server ### Finish and verify 🎉 -#### Astra voice agent -Open up http://localhost:3000 in browser to test Astra voice agent. +#### Astra multimodal agent +Open up http://localhost:3000 in browser to test Astra multimodal agent. #### Graph designer @@ -118,6 +118,74 @@ Open up another tab go to http://localhost:3001, and use graph designer to edit ![TEN Graph Designer](https://github.com/rte-design/docs/blob/main/assets/gifs/graph-designer.gif?raw=true) +
+

Feature comparison

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeaturesTENDifyLangChainFlowise
Opensourced Multimodal Agent✅❌❌❌
Extension Store✅❌❌❌
Python, Go and C++ for Extensions✅❌❌❌
All-in-one Package Manager✅❌❌❌
Agora RTC Transportation✅❌❌❌
RAG✅✅✅✅
Workflow✅✅✅✅
Local Deployment✅✅✅✅
+

TEN Platform

diff --git a/playground/src/platform/pc/description/index.tsx b/playground/src/platform/pc/description/index.tsx index 432e2a94..2b395d9b 100644 --- a/playground/src/platform/pc/description/index.tsx +++ b/playground/src/platform/pc/description/index.tsx @@ -87,7 +87,7 @@ const Description = () => { return
Description - Astra is an AI voice assistant powered by T.E.N framework, Deepgram, Eleven Labs, and ChatGPT. + Astra is a multimodal agent powered by TEN {!agentConnected ? "Connect" : "Disconnect"} From 007173e623a06ea2f662c99edf7f9b990d91ba52 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=B4=9D=E5=90=89=E5=A1=94=E5=A4=A7=E7=8E=8B?= Date: Wed, 21 Aug 2024 07:23:52 +0800 Subject: [PATCH 3/5] Update README.md --- README.md | 76 ++++++++----------------------------------------------- 1 file changed, 11 insertions(+), 65 deletions(-) diff --git a/README.md b/README.md index af977508..aca42dc6 100644 --- a/README.md +++ b/README.md @@ -120,71 +120,17 @@ Open up another tab go to http://localhost:3001, and use graph designer to edit

Feature comparison

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeaturesTENDifyLangChainFlowise
Opensourced Multimodal Agent✅❌❌❌
Extension Store✅❌❌❌
Python, Go and C++ for Extensions✅❌❌❌
All-in-one Package Manager✅❌❌❌
Agora RTC Transportation✅❌❌❌
RAG✅✅✅✅
Workflow✅✅✅✅
Local Deployment✅✅✅✅
+ +| Features | TEN | Dify | LangChain | Flowise | +|---------------------------------|-----|------|-----------|---------| +| Opensourced Multimodal Agent | ✅ | ❌ | ❌ | ❌ | +| Extension Store | ✅ | ❌ | ❌ | ❌ | +| Python, Go and C++ for Extensions | ✅ | ❌ | ❌ | ❌ | +| All-in-one Package Manager | ✅ | ❌ | ❌ | ❌ | +| Agora RTC Transportation | ✅ | ❌ | ❌ | ❌ | +| RAG | ✅ | ✅ | ✅ | ✅ | +| Workflow | ✅ | ✅ | ✅ | ✅ | +| Local Deployment | ✅ | ✅ | ✅ | ✅ |

TEN Platform

From b0d0afd2f4f5d16a1cce37042df6dd1a14cccd0f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=B4=9D=E5=90=89=E5=A1=94=E5=A4=A7=E7=8E=8B?= Date: Wed, 21 Aug 2024 08:04:47 +0800 Subject: [PATCH 4/5] Centered the comparison table --- README.md | 27 ++++++++++++++++----------- 1 file changed, 16 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index aca42dc6..8f88a9d3 100644 --- a/README.md +++ b/README.md @@ -73,8 +73,8 @@ Open the `.env` file and fill in the `keys` and `regions`. This is also where yo ```bash # Agora App ID and Agora App Certificate AGORA_APP_ID= -# Leave empty unless you have enabled the certificate -AGORA_APP_CERTIFICATE= "" +# Leave empty unless you have enabled the certificate within the Agora account. +AGORA_APP_CERTIFICATE= # Azure STT key and region AZURE_STT_KEY= @@ -121,16 +121,21 @@ Open up another tab go to http://localhost:3001, and use graph designer to edit

Feature comparison

+
+ | Features | TEN | Dify | LangChain | Flowise | -|---------------------------------|-----|------|-----------|---------| -| Opensourced Multimodal Agent | ✅ | ❌ | ❌ | ❌ | -| Extension Store | ✅ | ❌ | ❌ | ❌ | -| Python, Go and C++ for Extensions | ✅ | ❌ | ❌ | ❌ | -| All-in-one Package Manager | ✅ | ❌ | ❌ | ❌ | -| Agora RTC Transportation | ✅ | ❌ | ❌ | ❌ | -| RAG | ✅ | ✅ | ✅ | ✅ | -| Workflow | ✅ | ✅ | ✅ | ✅ | -| Local Deployment | ✅ | ✅ | ✅ | ✅ | +|---------------------------------|:---:|:----:|:---------:|:-------:| +| Opensourced Multimodal Agent | ✅ | ❌ | ❌ | ❌ | +| Extension Store | ✅ | ❌ | ❌ | ❌ | +| Python, Go and C++ for Extensions | ✅ | ❌ | ❌ | ❌ | +| All-in-one Package Manager | ✅ | ❌ | ❌ | ❌ | +| Agora RTC Transportation | ✅ | ❌ | ❌ | ❌ | +| RAG | ✅ | ✅ | ✅ | ✅ | +| Workflow | ✅ | ✅ | ✅ | ✅ | +| Local Deployment | ✅ | ✅ | ✅ | ✅ | + + +

TEN Platform

From 383c5da8e3c1ea9cf352ff4a77e6b51cab9bb56c Mon Sep 17 00:00:00 2001 From: Elliott Chen Date: Wed, 21 Aug 2024 17:39:18 +0800 Subject: [PATCH 5/5] Update README.md --- README.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 8f88a9d3..139aa8fd 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ +![Astra banner image](https://github.com/rte-design/docs/blob/main/assets/imgs/astra-banner.jpg?raw=true)
-[![Follow on X](https://img.shields.io/twitter/follow/ten_platform?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=ten_platform) +[![Follow on X](https://img.shields.io/twitter/follow/AstraAIAgent?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=AstraAIAgent) ![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/rte-design/astra.ai?labelColor=%20%23FDB062&color=%20%23f79009)](https://github.com/rte-design/astra.ai/discussions/) [![Commits](https://img.shields.io/github/commit-activity/m/rte-design/astra.ai?labelColor=%20%237d89b0&color=%20%235d6b98)](https://github.com/rte-design/astra.ai/graphs/commit-activity) @@ -119,28 +120,27 @@ Open up another tab go to http://localhost:3001, and use graph designer to edit ![TEN Graph Designer](https://github.com/rte-design/docs/blob/main/assets/gifs/graph-designer.gif?raw=true)
-

Feature comparison

- -
+

TEN Platform

-| Features | TEN | Dify | LangChain | Flowise | -|---------------------------------|:---:|:----:|:---------:|:-------:| -| Opensourced Multimodal Agent | ✅ | ❌ | ❌ | ❌ | -| Extension Store | ✅ | ❌ | ❌ | ❌ | -| Python, Go and C++ for Extensions | ✅ | ❌ | ❌ | ❌ | -| All-in-one Package Manager | ✅ | ❌ | ❌ | ❌ | -| Agora RTC Transportation | ✅ | ❌ | ❌ | ❌ | -| RAG | ✅ | ✅ | ✅ | ✅ | -| Workflow | ✅ | ✅ | ✅ | ✅ | -| Local Deployment | ✅ | ✅ | ✅ | ✅ | +Now that you’ve created your first AI agent, the creativity doesn't stop here. To develop more amazing agents, you’ll need an advanced understanding of how the TEN service works under the hood. Please refer to the [ TEN platform documentation ](https://doc.theten.ai). +
+

TEN Feature Comparison

-
+
-
-

TEN Platform

+| **Features** | **TEN** | **Dify** | **LangChain** | **Flowise** | +|:----------------------------------------:|:-------:|:--------:|:-------------:|:-----------:| +| **Opensourced Multimodal Agent** | ✅ | ❌ | ❌ | ❌ | +| **Python, Go, and C++ for Extensions** | ✅ | ❌ | ❌ | ❌ | +| **All-in-one Package Manager** | ✅ | ❌ | ❌ | ❌ | +| **RTC Transportation** | ✅ | ❌ | ❌ | ❌ | +| **Extension Store** | ✅ | ✅ | ❌ | ❌ | +| **RAG** | ✅ | ✅ | ✅ | ✅ | +| **Workflow Builder** | ✅ | ✅ | ✅ | ✅ | +| **Local Deployment** | ✅ | ✅ | ✅ | ✅ | -Now that you’ve created your first AI agent, the creativity doesn't stop here. To develop more amazing agents, you’ll need an advanced understanding of how the TEN service works under the hood. Please refer to the [ TEN platform documentation ](https://doc.theten.ai). +

Stay Tuned