diff --git a/docs/readmes/README-CN.md b/docs/readmes/README-CN.md index ce47fd43..fb892587 100644 --- a/docs/readmes/README-CN.md +++ b/docs/readmes/README-CN.md @@ -1,28 +1,29 @@ -![Astra banner image](https://github.com/TEN-framework/docs/blob/main/assets/jpg/astra_banner.jpg?raw=true) +![Banner de TEN Agent](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) +[![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%239b8afb&color=%20%237a5af8)](https://github.com/TEN-framework/ten-agent/blob/main/LICENSE) +[![WeChat](https://img.shields.io/badge/WeChat-WeChat_Group-%2307C160?logo=wechat)](https://github.com/TEN-framework/ten-agent/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) +[![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 +README in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano
@@ -32,21 +33,46 @@   •   [快速开始](https://doc.theten.ai/getting-started/quickstart)   •   -[教程](https://doc.theten.ai/getting-started/create-a-hello-world-extension) +[TEN Framework 仓库](https://github.com/TEN-framework/ten_framework) +**TEN Agent**,由世界首个实时多模态框架驱动。它是开源的,具有说话、视觉和访问知识库的能力。通过利用 TEN 框架,TEN Agent 具有以下特点: + +1. **高性能实时多模态交互**: +为复杂的音视频 AI 应用提供高性能、低延迟的解决方案。 + +2. **多语言和多平台支持**: +支持 C++、Go、Python 等语言的扩展开发。可在 Windows、Mac、Linux 和移动设备上运行。 + +3. **边缘-云集成**: +灵活结合边缘和云部署的扩展,平衡隐私、成本和性能。 + +4. **超越模型限制的灵活性**: +通过简单的拖放编程,轻松构建复杂的 AI 应用,集成音视频工具、数据库、RAG 等。 + +5. **实时代理状态管理**: +实时管理和调整代理行为,实现动态响应。 +
-## Astra agent +

点星收藏

+ +我们更新频繁,不想错过的话,请给我们的 repo 点星,以便获得第一时间的更新. + +![TEN star us gif](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_us_2.gif?raw=true) -[Astra agent](https://theastra.ai) 是通过 TEN 搭建出来的 multimodal AI agent, 展示了其多模态,低延迟的能力。 +
+

TEN Agent

+ +[TEN Agent](https://agent.theten.ai) -[![Showcase Astra 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 进行推理方面的能力。 +[![展示 TEN 多模态代理](https://github.com/TEN-framework/docs/blob/main/assets/gif/features.gif?raw=true)](https://agent.theten.ai)
-

如何本地搭建 Astra agent

+

如何在本地构建 TEN Agent ### 先决条件 #### Keys @@ -146,39 +172,29 @@ make run-server 走到这里就本地构建完成了,简单 5 步,上手体验拉满! -#### 验证 Astra agent +#### 验证 TEN Agent -现在可以打开浏览器 http://localhost:3000 体验 Astra agent +现在可以打开浏览器 http://localhost:3000 体验 TEN Agent -#### 验证 Graph designer +#### 验证 Graph Designer -同时可以再开一个 tab 在 http://localhost:3001 体验 Graph Designer (beta),通过简单拖拽和动态节点连接轻松定制 Astra agent。 +同时可以再开一个 tab 在 http://localhost:3001 体验 Graph Designer,通过简单拖拽和动态节点连接轻松定制 TEN Agent。 ![TEN Graph Designer](https://github.com/TEN-framework/docs/blob/main/assets/gif/graph_designer.gif?raw=true) -
-

点星收藏

- -我们更新频繁,不想错过的话,请给我们的 repo 点星,以便获得第一时间的更新. - -![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): 如果喜欢用微信群的社区,欢迎加入。 -- [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):非常适合分享您的代理并与社区互动。 - +- [WeChat Group](https://github.com/TEN-framework/ten-agent/discussions/170): 如果喜欢用微信群的社区,欢迎加入。 +- [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 Agent](https://contrib.rocks/image?repo=TEN-framework/ten-agent)](https://github.com/TEN-framework/ten-agent/graphs/contributors)

欢迎贡献

diff --git a/docs/readmes/README-ES.md b/docs/readmes/README-ES.md index b5bc5364..22145a54 100644 --- a/docs/readmes/README-ES.md +++ b/docs/readmes/README-ES.md @@ -1,55 +1,79 @@ -![Astra banner image](https://github.com/TEN-framework/docs/blob/main/assets/jpg/astra_banner.jpg?raw=true) +![Banner de TEN Agent](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) -![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%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ASTRA.ai/blob/main/LICENSE) +[![Seguir en X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=TenFramework) +![Producto gratuito](https://img.shields.io/badge/precio-gratuito-blue.svg?labelColor=%20%239b8afb&color=%20%237a5af8) +[![Publicaciones en discusiones](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 cerrados](https://img.shields.io/github/issues-search?query=repo%3ATEN-framework%2Ften-agent%20is%3Aclosed&label=issues%20cerrados&labelColor=green&color=green)](https://github.com/TEN-framework/ten-agent/issues) +[![PRs Bienvenidos](https://img.shields.io/badge/PRs-bienvenidos-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ten-agent/pulls) +[![Licencia GitHub](https://img.shields.io/badge/Licencia-Apache_2.0-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ten-agent/blob/main/LICENSE) + +[![Comunidad TEN en Discord](https://dcbadge.vercel.app/api/server/VnPftUzAMJ)](https://discord.gg/VnPftUzAMJ) + +[![Observadores de GitHub](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) +[![Forks de GitHub](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) +[![Estrellas de GitHub](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 en Inglés +简体中文操作指南 +日本語のREADME +README en 한국어 +README en Español +README en Français +README en Italiano + +[Comenzar](https://doc.theten.ai/ten-agent/getting_started) +  •   +[Crear Extensiones](https://doc.theten.ai/ten-agent/create_a_hello_world_extension) +  •   +[Repositorio del Framework TEN](https://github.com/TEN-framework/ten_framework) -[![Discord TEN Community](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) +**TEN Agent**, impulsado por el primer framework multimodal en tiempo real del mundo. Es de código abierto, con la capacidad de hablar, ver y acceder a una base de conocimientos. Aprovechando el Framework TEN, TEN Agent tiene las siguientes características: -README in English -简体中文操作指南 -日本語のREADME -README in 한국어 -README en Español -README en Français -README in Italiano +1. **Interacciones Multimodales en Tiempo Real de Alto Rendimiento**: +Ofrece soluciones de alto rendimiento y baja latencia para aplicaciones complejas de IA audiovisual. +2. **Soporte Multi-Idioma y Multi-Plataforma**: +Soporta desarrollo de extensiones en C++, Go, Python, etc. Se ejecuta en Windows, Mac, Linux y dispositivos móviles. -[Documentación](https://doc.theten.ai) -  •   -[Empezando](https://doc.theten.ai/getting-started/quickstart) -  •   -[Tutoriales](https://doc.theten.ai/getting-started/create-a-hello-world-extension) +3. **Integración Edge-Cloud**: +Combina de manera flexible extensiones desplegadas en el borde y en la nube, equilibrando privacidad, costo y rendimiento. +4. **Flexibilidad Más Allá de las Limitaciones del Modelo**: +Construye fácilmente aplicaciones complejas de IA mediante programación simple de arrastrar y soltar, integrando herramientas audiovisuales, bases de datos, RAG y más. - +5. **Gestión de Estado del Agente en Tiempo Real**: +Gestiona y ajusta el comportamiento del agente en tiempo real para una respuesta dinámica. + +
+

Mantente Atento

+ +Antes de comenzar, asegúrate de marcar con una estrella nuestro repositorio y recibir notificaciones instantáneas de todos los nuevos lanzamientos. + +![GIF de TEN danos una estrella](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_us_2.gif?raw=true)
-

Astra - un agente multimodal

+

TEN Agent

+ +[TEN Agent](https://agent.theten.ai) -[Astra multimodal agent](https://theastra.ai) +TEN Agent es un agente multimodal impulsado por [TEN](https://theten.ai), que demuestra sus capacidades en habla, visión y razonamiento a través de RAG desde documentación local. -Astra es un agente multimodal impulsado por [TEN](https://doc.theten.ai), que demuestra sus capacidades en habla, visión y razonamiento a través de RAG a partir de la documentación local. +[![Demostración del agente multimodal TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/features.gif?raw=true)](https://agent.theten.ai) -[![Demostración del agente multimodal Astra](https://github.com/TEN-framework/docs/blob/main/assets/gif/astra_voice_agent.gif?raw=true)](https://theastra.ai)
-

Cómo construir Astra localmente +

Cómo construir TEN Agent localmente

-### Requisitos previos +### Prerrequisitos #### Claves -- ID de aplicación y certificado de aplicación de Agora ([lea aquí cómo](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web)) -- Claves de API de [speech-to-text](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) y [text-to-speech](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) de Azure -- Clave de API de [OpenAI](https://openai.com/index/openai-api/) +- Agora [App ID](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) y [App Certificate](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) (el certificado no es obligatorio) +- Claves API de Azure [SST](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) y [TTS](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) (siéntete libre de usar otro proveedor) +- Clave API de [OpenAI](https://openai.com/index/openai-api/) #### Instalación - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) @@ -60,26 +84,26 @@ Astra es un agente multimodal impulsado por [TEN](https://doc.theten.ai), que de - RAM >= 4 GB #### Configuración de Docker en Apple Silicon -Si está utilizando Apple Silicon, deberá desmarcar la opción "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" en Docker, de lo contrario, el servidor no funcionará. +Necesitarás desmarcar la opción "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" en Docker si estás en Apple Silicon, de lo contrario el servidor no funcionará. ![Configuración de Docker](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true) ### Siguiente paso #### 1. Modificar archivos de configuración -En la raíz del proyecto, usa el siguiente comando para crear .env a partir del ejemplo. +En la raíz del proyecto, usa el comando `cp` para crear `.env` a partir del ejemplo. -Se utilizarán para almacenar información para `docker compose` más adelante. +Se utilizará para almacenar información para `docker compose` más adelante. ```bash cp ./.env.example ./.env ``` -#### 2. Configurar claves de API -Abre el archivo `.env` y completa las secciones `keys` y `regions`. Aquí también puedes elegir usar diferentes `extensions`: +#### 2. Configurar claves API +Abre el archivo `.env` y completa las `claves` y `regiones`. Aquí también puedes elegir usar cualquier `extensión` diferente: ```bash # Agora App ID y Agora App Certificate AGORA_APP_ID= -# Deja en blanco a menos que hayas habilitado el certificado dentro de la cuenta de Agora. +# Dejar vacío a menos que hayas habilitado el certificado en la cuenta de Agora. AGORA_APP_CERTIFICATE= # Clave y región de Azure STT @@ -90,7 +114,7 @@ AZURE_STT_REGION= AZURE_TTS_KEY= AZURE_TTS_REGION= -# Clave de API de OpenAI +# Clave API de OpenAI OPENAI_API_KEY= ``` @@ -100,80 +124,68 @@ En el mismo directorio, ejecuta el comando `docker compose up` para componer los docker compose up ``` -#### 4. Ingresar al contenedor y construir el agente -Abre una ventana de terminal separada, ingresa al contenedor y construye el agente: +#### 4. Entrar al contenedor y construir el agente +Abre una nueva ventana de terminal, entra al contenedor y construye el agente: ```bash docker exec -it astra_agents_dev bash make build ``` #### 5. Iniciar el servidor -Una vez que se haya completado la construcción, ejecuta `make run-server` en el puerto `8080`: +Una vez que la construcción esté completa, ejecuta `make run-server` en el puerto `8080`: ```bash make run-server ``` -### ¡Finaliza y verifica 🎉 - -#### Agente multimodal Astra -Abre http://localhost:3000 en el navegador para probar el agente multimodal Astra. +### Finalizar y verificar 🎉 -#### Diseñador de gráficos +#### TEN Agent +Abre http://localhost:3000 en el navegador para jugar y probar TEN Agent. -Abre otra pestaña e ingresa a http://localhost:3001, y utiliza el diseñador de gráficos para editar el flujo y las propiedades de cualquier extensión. +#### Diseñador de Gráficos -![Diseñador de gráficos TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/graph_designer.gif?raw=true) - -
-

Plataforma TEN

+Abre otra pestaña y ve a http://localhost:3001, y usa el Diseñador de Gráficos para crear, conectar y editar extensiones en el lienzo. -Ahora que has creado tu primer agente de IA, la creatividad no se detiene aquí. Para desarrollar agentes más sorprendentes, necesitarás una comprensión avanzada de cómo funciona el servicio TEN en el fondo. Consulta la [documentación de la plataforma TEN](https://doc.theten.ai). +![Diseñador de Gráficos TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/graph_designer.gif?raw=true)
-

Comparación de características de TEN

+

Comparación de TEN Agent

-| **Características** | **TEN** | **Dify** | **LangChain** | **Flowise** | -|:----------------------------------------:|:-------:|:--------:|:-------------:|:-----------:| -| **Agente multimodal de código abierto** | ✅ | ❌ | ❌ | ❌ | -| **Python, Go y C++ para extensiones** | ✅ | ❌ | ❌ | ❌ | -| **Gestor de paquetes todo en uno** | ✅ | ❌ | ❌ | ❌ | -| **Transporte RTC** | ✅ | ❌ | ❌ | ❌ | -| **Tienda de extensiones** | ✅ | ✅ | ❌ | ❌ | -| **RAG** | ✅ | ✅ | ✅ | ✅ | -| **Constructor de flujo de trabajo** | ✅ | ✅ | ✅ | ✅ | -| **Implementación local** | ✅ | ✅ | ✅ | ✅ | +| **Características** | **TEN Agent** | **Pipecat** | **LiveKit:KITT** | **Vapi.ai** | **DailyBots** | **Play.ai** | +|:----------------------------------------:|:-------:|:--------:|:-------------:|:----------------:|:----------------:|:----------------:| +| **Visión** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Rico soporte TTS para diferentes idiomas** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Soporte Go para extensiones** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Soporte C++ para extensiones** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Soporte RAG** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Constructor de flujos de trabajo para extensiones** | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | +| **Rico soporte LLM** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Soporte Python para extensiones** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Código abierto** | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |

-

Mantente informado

+

Únete a la Comunidad

-Antes de continuar, ¡asegúrate de marcar nuestro repositorio como favorito y recibir notificaciones instantáneas sobre todas las nuevas versiones! - -![TEN marcar repositorio 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): Ideal para compartir tus aplicaciones e interactuar con la comunidad. +- [Discusiones de GitHub](https://github.com/TEN-framework/ten-agent/discussions): Perfecto para proporcionar comentarios y hacer preguntas. +- [Issues de GitHub](https://github.com/TEN-framework/ten-agent/issues): Mejor para reportar errores y proponer nuevas características. Consulta nuestras [pautas de contribución](./docs/code-of-conduct/contributing.md) para más detalles. +- [X (anteriormente Twitter)](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5): Excelente para compartir tus agentes e interactuar con la comunidad.
-

Únete a la comunidad

+

Contribuidores de Código

-- [Discord](https://discord.gg/VnPftUzAMJ): Ideal para compartir tus aplicaciones y participar en la comunidad. -- [Discusión en GitHub](https://github.com/TEN-framework/astra.ai/discussions): Perfecto para brindar comentarios y hacer preguntas. -- [Informar problemas en GitHub](https://github.com/TEN-framework/astra.ai/issues): Lo mejor para informar errores y proponer nuevas características. Consulta nuestras [pautas de contribución](./docs/code-of-conduct/contributing.md) para obtener más detalles. -- [X (anteriormente Twitter)](https://img.shields.io/twitter/follow/AstraAIAgent?logo=X&color=%20%23f5f5f5): Genial para compartir tus agentes e interactuar con la comunidad. +[![TEN](https://contrib.rocks/image?repo=TEN-framework/ten-agent)](https://github.com/TEN-framework/ten-agent/graphs/contributors)
-

Contribuyentes de código

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

Pautas de contribución

+

Pautas de Contribución

¡Las contribuciones son bienvenidas! Por favor, lee primero las [pautas de contribución](./docs/code-of-conduct/contributing.md).

Licencia

-Este proyecto está licenciado bajo la Licencia Apache 2.0. Consulta el archivo [LICENSE](LICENSE) para obtener más detalles. - +Este proyecto está licenciado bajo la Licencia Apache 2.0 - consulta el archivo [LICENSE](LICENSE) para más detalles. diff --git a/docs/readmes/README-FR.md b/docs/readmes/README-FR.md index 2decc504..64d3e052 100644 --- a/docs/readmes/README-FR.md +++ b/docs/readmes/README-FR.md @@ -1,54 +1,79 @@ -![Astra banner image](https://github.com/TEN-framework/docs/blob/main/assets/jpg/astra_banner.jpg?raw=true) +![Bannière TEN Agent](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) -![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%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ASTRA.ai/blob/main/LICENSE) +[![Suivre sur X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=TenFramework) +![Produit gratuit](https://img.shields.io/badge/prix-gratuit-blue.svg?labelColor=%20%239b8afb&color=%20%237a5af8) +[![Publications dans les discussions](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) +[![Problèmes fermés](https://img.shields.io/github/issues-search?query=repo%3ATEN-framework%2Ften-agent%20is%3Aclosed&label=problèmes%20fermés&labelColor=green&color=green)](https://github.com/TEN-framework/ten-agent/issues) +[![PRs Bienvenues](https://img.shields.io/badge/PRs-bienvenues-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ten-agent/pulls) +[![Licence GitHub](https://img.shields.io/badge/Licence-Apache_2.0-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ten-agent/blob/main/LICENSE) + +[![Communauté TEN sur Discord](https://dcbadge.vercel.app/api/server/VnPftUzAMJ)](https://discord.gg/VnPftUzAMJ) + +[![Observateurs GitHub](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) +[![Forks GitHub](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) +[![Étoiles GitHub](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 en Anglais +简体中文操作指南 +日本語のREADME +README en 한국어 +README en Español +README en Français +README en Italiano + +[Commencer](https://doc.theten.ai/ten-agent/getting_started) +  •   +[Créer des Extensions](https://doc.theten.ai/ten-agent/create_a_hello_world_extension) +  •   +[Dépôt du Framework TEN](https://github.com/TEN-framework/ten_framework) -[![Discord TEN Community](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) +**TEN Agent**, propulsé par le premier framework multimodal en temps réel au monde. Il est open-source, avec la capacité de parler, voir et accéder à une base de connaissances. En tirant parti du Framework TEN, TEN Agent possède les caractéristiques suivantes : -README in English -简体中文操作指南 -日本語のREADME -README in 한국어 -README en Español -README en Français -README in Italiano +1. **Interactions Multimodales en Temps Réel Haute Performance** : +Offre des solutions haute performance et à faible latence pour des applications complexes d'IA audiovisuelle. +2. **Support Multi-Langues et Multi-Plateformes** : +Supporte le développement d'extensions en C++, Go, Python, etc. Fonctionne sur Windows, Mac, Linux et appareils mobiles. -[Documentation](https://doc.theten.ai) -  •   -[Commencer](https://doc.theten.ai/getting-started/quickstart) -  •   -[Tutoriels](https://doc.theten.ai/getting-started/create-a-hello-world-extension) +3. **Intégration Edge-Cloud** : +Combine de manière flexible les extensions déployées en périphérie et dans le cloud, équilibrant confidentialité, coût et performance. - +4. **Flexibilité Au-delà des Limitations du Modèle** : +Construisez facilement des applications IA complexes grâce à une programmation simple par glisser-déposer, intégrant des outils audiovisuels, des bases de données, RAG et plus encore. + +5. **Gestion d'État de l'Agent en Temps Réel** : +Gère et ajuste le comportement de l'agent en temps réel pour une réponse dynamique. + +
+

Restez à l'écoute

+ +Avant de commencer, assurez-vous de mettre une étoile à notre dépôt et recevez des notifications instantanées pour toutes les nouvelles versions ! + +![GIF étoile TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_us_2.gif?raw=true)
-

Astra - un agent multimodal

+

TEN Agent

+ +[TEN Agent](https://agent.theten.ai) -[Agent multimodal Astra](https://theastra.ai) +TEN Agent est un agent multimodal propulsé par [TEN](https://theten.ai), démontrant ses capacités en matière de parole, de vision et de raisonnement grâce au RAG à partir de la documentation locale. -Astra est un agent multimodal alimenté par [TEN](https://doc.theten.ai), démontrant ses capacités en matière de parole, de vision et de raisonnement grâce à RAG à partir de la documentation locale. +[![Démonstration de l'agent multimodal TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/features.gif?raw=true)](https://agent.theten.ai) -[![Présentation de l'agent multimodal Astra](https://github.com/TEN-framework/docs/blob/main/assets/gif/astra_voice_agent.gif?raw=true)](https://theastra.ai)
-

Comment construire Astra localement +

Comment construire TEN Agent localement

### Prérequis #### Clés -- ID et certificat d'application Agora ([lire ici comment](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web)) -- Clés d'API de [speech-to-text](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) et de [text-to-speech](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) d'Azure -- Clé d'API [OpenAI](https://openai.com/index/openai-api/) +- Agora [App ID](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) et [App Certificate](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) (le certificat n'est pas requis) +- Clés API Azure [SST](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) et [TTS](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) (n'hésitez pas à utiliser un autre fournisseur) +- Clé API [OpenAI](https://openai.com/index/openai-api/) #### Installation - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) @@ -58,27 +83,27 @@ Astra est un agent multimodal alimenté par [TEN](https://doc.theten.ai), démon - CPU >= 2 cœurs - RAM >= 4 Go -#### Paramètres Docker sur Apple Silicon -Si vous utilisez Apple Silicon, vous devrez décocher l'option "Utiliser Rosetta pour l'émulation x86_64/amd64 sur Apple Silicon" pour Docker, sinon le serveur ne fonctionnera pas. +#### Configuration Docker sur Apple Silicon +Vous devrez décocher l'option "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" pour Docker si vous êtes sur Apple Silicon, sinon le serveur ne fonctionnera pas. -![Paramètres Docker](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true) +![Configuration Docker](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true) -### Étape suivante +### Étapes suivantes #### 1. Modifier les fichiers de configuration -À la racine du projet, utilisez la commande cp pour créer .env à partir de l’exemple. +À la racine du projet, utilisez la commande `cp` pour créer `.env` à partir de l'exemple. -Ils seront utilisés pour stocker les informations pour `docker compose` ultérieurement. +Il sera utilisé pour stocker les informations pour `docker compose` plus tard. ```bash cp ./.env.example ./.env ``` -#### 2. Configuration des clés API -Ouvrez le fichier `.env` et remplissez les champs `keys` et `regions`. C'est également ici que vous pouvez choisir d'utiliser différentes `extensions` : +#### 2. Configurer les clés API +Ouvrez le fichier `.env` et remplissez les `clés` et `régions`. C'est également ici que vous pouvez choisir d'utiliser différentes `extensions` : ```bash # Agora App ID et Agora App Certificate AGORA_APP_ID= -# Laissez vide à moins que vous n'ayez activé le certificat dans le compte Agora. +# Laissez vide sauf si vous avez activé le certificat dans le compte Agora. AGORA_APP_CERTIFICATE= # Clé et région Azure STT @@ -99,8 +124,8 @@ Dans le même répertoire, exécutez la commande `docker compose up` pour compos docker compose up ``` -#### 4. Accéder au conteneur et construire l'agent -Ouvrez une nouvelle fenêtre de terminal, accédez au conteneur et construisez l'agent : +#### 4. Entrer dans le conteneur et construire l'agent +Ouvrez une nouvelle fenêtre de terminal, entrez dans le conteneur et construisez l'agent : ```bash docker exec -it astra_agents_dev bash make build @@ -114,56 +139,46 @@ make run-server ### Terminé et vérifié 🎉 -#### Agent multimodal Astra -Ouvrez http://localhost:3000 dans votre navigateur pour tester l'agent multimodal Astra. +#### TEN Agent +Ouvrez http://localhost:3000 dans le navigateur pour jouer et tester TEN Agent. -#### Concepteur de graphiques -Ouvrez un autre onglet et allez sur http://localhost:3001 pour utiliser le concepteur de graphiques et modifier le flux et les propriétés des extensions. +#### Concepteur de graphes -![Concepteur de graphiques TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/graph_designer.gif?raw=true) - -
-

Plateforme TEN

+Ouvrez un autre onglet et allez sur http://localhost:3001, et utilisez le Concepteur de graphes pour créer, connecter et modifier les extensions sur le canevas. -Maintenant que vous avez créé votre premier agent d'IA, la créativité ne s'arrête pas là. Pour développer d'autres agents incroyables, vous aurez besoin d'une compréhension avancée du fonctionnement du service TEN. Veuillez consulter la [documentation de la plateforme TEN](https://doc.theten.ai). +![Concepteur de graphes TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/graph_designer.gif?raw=true)
-

Comparaison des fonctionnalités TEN

+

Comparaison de TEN Agent

-| **Fonctionnalités** | **TEN** | **Dify** | **LangChain** | **Flowise** | -|:----------------------------------------:|:-------:|:--------:|:-------------:|:-----------:| -| **Agent multimodal open source** | ✅ | ❌ | ❌ | ❌ | -| **Extensions en Python, Go et C++** | ✅ | ❌ | ❌ | ❌ | -| **Gestionnaire de paquets tout-en-un** | ✅ | ❌ | ❌ | ❌ | -| **Transport RTC** | ✅ | ❌ | ❌ | ❌ | -| **Boutique d'extensions** | ✅ | ✅ | ❌ | ❌ | -| **RAG** | ✅ | ✅ | ✅ | ✅ | -| **Constructeur de flux** | ✅ | ✅ | ✅ | ✅ | -| **Déploiement local** | ✅ | ✅ | ✅ | ✅ | +| **Fonctionnalités** | **TEN Agent** | **Pipecat** | **LiveKit:KITT** | **Vapi.ai** | **DailyBots** | **Play.ai** | +|:----------------------------------------:|:-------:|:--------:|:-------------:|:----------------:|:----------------:|:----------------:| +| **Vision** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Support TTS riche pour différentes langues** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Support Go pour les extensions** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Support C++ pour les extensions** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Support RAG** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Constructeur de flux de travail pour les extensions** | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | +| **Support LLM riche** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Support Python pour les extensions** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Open source** | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
-
-

Reste à l'écoute

- -Avant de continuer, assurez-vous de mettre une étoile à notre dépôt et recevez des notifications instantanées pour toutes les nouvelles versions ! - -![Animation étoile TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_the_repo_confetti_higher_quality.gif?raw=true) -

Rejoignez la communauté

- [Discord](https://discord.gg/VnPftUzAMJ) : Idéal pour partager vos applications et interagir avec la communauté. -- [Discussion GitHub](https://github.com/TEN-framework/astra.ai/discussions) : Parfait pour donner votre avis et poser des questions. -- [Problèmes GitHub](https://github.com/TEN-framework/astra.ai/issues) : Le meilleur moyen de signaler des bugs et de proposer de nouvelles fonctionnalités. Consultez nos [directives de contribution](./docs/code-of-conduct/contributing.md) pour plus de détails. -- [X (anciennement Twitter)](https://img.shields.io/twitter/follow/AstraAIAgent?logo=X&color=%20%23f5f5f5) : Idéal pour partager vos agents et interagir avec la communauté. +- [Discussion GitHub](https://github.com/TEN-framework/ten-agent/discussions) : Parfait pour fournir des commentaires et poser des questions. +- [Problèmes GitHub](https://github.com/TEN-framework/ten-agent/issues) : Meilleur endroit pour signaler des bugs et proposer de nouvelles fonctionnalités. Consultez nos [directives de contribution](./docs/code-of-conduct/contributing.md) pour plus de détails. +- [X (anciennement Twitter)](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5) : Excellent pour partager vos agents et interagir avec la communauté. -
-

Contributeurs au code

+
+

Contributeurs au code

-[![TEN](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)

Directives de contribution

@@ -173,4 +188,4 @@ Les contributions sont les bienvenues ! Veuillez d'abord lire les [directives de

Licence

-Ce projet est sous licence Apache 2.0 - consultez le fichier [LICENSE](LICENSE) pour plus de détails. +Ce projet est sous licence Apache 2.0 - voir le fichier [LICENSE](LICENSE) pour plus de détails. \ No newline at end of file diff --git a/docs/readmes/README-IT.md b/docs/readmes/README-IT.md index 31a39329..df3131a7 100644 --- a/docs/readmes/README-IT.md +++ b/docs/readmes/README-IT.md @@ -1,54 +1,78 @@ -![Astra banner image](https://github.com/TEN-framework/docs/blob/main/assets/jpg/astra_banner.jpg?raw=true) +![Banner di TEN Agent](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) -![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%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ASTRA.ai/blob/main/LICENSE) +[![Seguici su X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=TenFramework) +![Prezzo del prodotto](https://img.shields.io/badge/prezzo-gratuito-blue.svg?labelColor=%20%239b8afb&color=%20%237a5af8) +[![Post di discussione](https://img.shields.io/github/discussions/TEN-framework/ten-agent?labelColor=%20%23FDB062&color=%20%23f79009)](https://github.com/TEN-framework/ten-agent/discussions/) +[![Commit](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) +[![Problemi chiusi](https://img.shields.io/github/issues-search?query=repo%3ATEN-framework%2Ften-agent%20is%3Aclosed&label=problemi%20chiusi&labelColor=green&color=green)](https://github.com/TEN-framework/ten-agent/issues) +[![PR benvenute](https://img.shields.io/badge/PR-benvenute-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ten-agent/pulls) +[![Licenza GitHub](https://img.shields.io/badge/Licenza-Apache_2.0-blue.svg?labelColor=%20%23155EEF&color=%20%23528bff)](https://github.com/TEN-framework/ten-agent/blob/main/LICENSE) + +[![Comunità Discord TEN](https://dcbadge.vercel.app/api/server/VnPftUzAMJ)](https://discord.gg/VnPftUzAMJ) + +[![Osservatori GitHub](https://img.shields.io/github/watchers/TEN-framework/ten-agent?style=social&label=Osserva)](https://GitHub.com/TEN-framework/ten-agent/watchers/?WT.mc_id=academic-105485-koreyst) +[![Fork GitHub](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) +[![Stelle GitHub](https://img.shields.io/github/stars/TEN-framework/ten-agent?style=social&label=Stella)](https://GitHub.com/TEN-framework/ten-agent/stargazers/?WT.mc_id=academic-105485-koreyst) + +README in Inglese +README in Cinese Semplificato +README in Giapponese +README in Coreano +README in Spagnolo +README in Francese +README in Italiano + +[Inizia](https://doc.theten.ai/ten-agent/getting_started) +  •   +[Crea Estensioni](https://doc.theten.ai/ten-agent/create_a_hello_world_extension) +  •   +[Repository TEN Framework](https://github.com/TEN-framework/ten_framework) -[![Discord TEN Community](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) +**TEN Agent**, alimentato dal primo framework multimodale in tempo reale al mondo. È open-source, con la capacità di parlare, vedere e accedere a una base di conoscenza. Sfruttando il TEN Framework, TEN Agent ha le seguenti caratteristiche: -README in English -简体中文操作指南 -日本語のREADME -README in 한국어 -README en Español -README en Français -README in Italiano +1. **Interazioni Multimodali in Tempo Reale ad Alte Prestazioni**: +Offre soluzioni ad alte prestazioni e bassa latenza per complesse applicazioni AI audio-visive. +2. **Supporto Multi-Linguaggio e Multi-Piattaforma**: +Supporta lo sviluppo di estensioni in C++, Go, Python, ecc. Funziona su Windows, Mac, Linux e dispositivi mobili. -[Documentation](https://doc.theten.ai) -  •   -[Getting Started](https://doc.theten.ai/getting-started/quickstart) -  •   -[Tutorials](https://doc.theten.ai/getting-started/create-a-hello-world-extension) +3. **Integrazione Edge-Cloud**: +Combina in modo flessibile estensioni distribuite su edge e cloud, bilanciando privacy, costi e prestazioni. - +4. **Flessibilità Oltre i Limiti del Modello**: +Costruisci facilmente complesse applicazioni AI attraverso una semplice programmazione drag-and-drop, integrando strumenti audio-visivi, database, RAG e altro. + +5. **Gestione dello Stato dell'Agente in Tempo Reale**: +Gestisce e regola il comportamento dell'agente in tempo reale per una reattività dinamica.
-

Astra - un agente multimodale

+

Resta Aggiornato

-[Astra agente multimodale](https://theastra.ai) +Prima di iniziare, assicurati di mettere una stella al nostro repository per ricevere notifiche istantanee per tutti i nuovi rilasci! -Astra è un agente multimodale alimentato da [ TEN ](https://doc.theten.ai), che dimostra le sue capacità in termini di linguaggio, visione e ragionamento attraverso RAG dalla documentazione locale. +![GIF metti una stella a TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_us_2.gif?raw=true) -[![Mostra Astra agente multimodale](https://github.com/TEN-framework/docs/blob/main/assets/gif/astra_voice_agent.gif?raw=true)](https://theastra.ai)
-

Come costruire Astra localmente +

TEN Agent

+ +[TEN Agent](https://agent.theten.ai) + +TEN Agent è un agente multimodale alimentato da [TEN](https://theten.ai), che dimostra le sue capacità nel parlato, nella visione e nel ragionamento attraverso RAG dalla documentazione locale. + +[![Showcase dell'agente multimodale TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/features.gif?raw=true)](https://agent.theten.ai) +
+

Come costruire TEN Agent localmente

### Prerequisiti #### Chiavi -- Agora App ID e App Certificate([leggi qui come](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web)) -- Chiavi API di [speech-to-text](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) e [text-to-speech](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) di Azure -- Chiave API di [OpenAI](https://openai.com/index/openai-api/) +- Agora [App ID](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) e [App Certificate](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) (il certificato non è richiesto) +- Chiavi API Azure [SST](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) e [TTS](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) (sentiti libero di usare un altro provider) +- Chiave API [OpenAI](https://openai.com/index/openai-api/) #### Installazione - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) @@ -59,37 +83,37 @@ Astra è un agente multimodale alimentato da [ TEN ](https://doc.theten.ai), che - RAM >= 4 GB #### Impostazione Docker su Apple Silicon -Se si utilizza Apple Silicon, è necessario deselezionare l'opzione "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" per Docker, altrimenti il server non funzionerà. +Dovrai deselezionare l'opzione "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" per Docker se sei su Apple Silicon, altrimenti il server non funzionerà. ![Impostazione Docker](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true) ### Prossimo passo -#### 1. Modifica dei file di configurazione -Nella radice del progetto, usa il comando cp per creare .env dall’esempio. +#### 1. Modifica i file di configurazione +Nella root del progetto, usa il comando `cp` per creare `.env` dall'esempio. -Verranno utilizzati per memorizzare le informazioni per `docker compose` successivamente. +Sarà usato per memorizzare informazioni per `docker compose` più tardi. ```bash cp ./.env.example ./.env ``` -#### 2. Configurazione delle chiavi API -Apri il file `.env` e compila le sezioni `keys` e `regions`. Puoi anche scegliere di utilizzare diverse `extensions`: +#### 2. Configura le chiavi API +Apri il file `.env` e inserisci le `chiavi` e le `regioni`. Qui puoi anche scegliere di usare qualsiasi `estensione` diversa: ```bash # Agora App ID e Agora App Certificate AGORA_APP_ID= -# Lascia vuoto a meno che tu non abbia abilitato il certificato all'interno dell'account Agora. +# Lascia vuoto a meno che tu non abbia abilitato il certificato nell'account Agora. AGORA_APP_CERTIFICATE= -# Chiave e regione di Azure STT +# Chiave e regione Azure STT AZURE_STT_KEY= AZURE_STT_REGION= -# Chiave e regione di Azure TTS +# Chiave e regione Azure TTS AZURE_TTS_KEY= AZURE_TTS_REGION= -# Chiave API di OpenAI +# Chiave API OpenAI OPENAI_API_KEY= ``` @@ -99,79 +123,70 @@ Nella stessa directory, esegui il comando `docker compose up` per comporre i con docker compose up ``` -#### 4. Entra nel container e crea l'agente -Apri una finestra del terminale separata, entra nel container e crea l'agente: +#### 4. Entra nel container e costruisci l'agente +Apri una finestra di terminale separata, entra nel container e costruisci l'agente: ```bash docker exec -it astra_agents_dev bash make build ``` #### 5. Avvia il server -Una volta completata la compilazione, esegui `make run-server` sulla porta `8080`: +Una volta completata la build, esegui `make run-server` sulla porta `8080`: ```bash make run-server ``` -### Completato e verifica 🎉 +### Finisci e verifica 🎉 -#### Astra agente multimodale -Apri http://localhost:3000 nel browser per testare Astra agente multimodale. +#### TEN Agent +Apri http://localhost:3000 nel browser per giocare e testare TEN Agent. -#### Graph designer +#### Graph Designer -Apri un'altra scheda e vai su http://localhost:3001, utilizza il graph designer per modificare il flusso e le proprietà delle estensioni. +Apri un'altra scheda e vai su http://localhost:3001, e usa Graph Designer per creare, connettere e modificare le estensioni sulla tela. ![TEN Graph Designer](https://github.com/TEN-framework/docs/blob/main/assets/gif/graph_designer.gif?raw=true)
-

La piattaforma TEN

- -Ora che hai creato il tuo primo agente di intelligenza artificiale, la creatività non si ferma qui. Per sviluppare agenti ancora più sorprendenti, avrai bisogno di una comprensione avanzata di come funziona il servizio TEN nel dettaglio. Consulta la [documentazione della piattaforma TEN](https://doc.theten.ai). - -
-

Confronto delle funzionalità di TEN

+

Confronto TEN Agent

-| **Funzionalità** | **TEN** | **Dify** | **LangChain** | **Flowise** | -|:----------------------------------------:|:-------:|:--------:|:-------------:|:-----------:| -| **Agente multimodale open source** | ✅ | ❌ | ❌ | ❌ | -| **Estensioni in Python, Go e C++** | ✅ | ❌ | ❌ | ❌ | -| **Gestore pacchetti all-in-one** | ✅ | ❌ | ❌ | ❌ | -| **Trasporto RTC** | ✅ | ❌ | ❌ | ❌ | -| **Store di estensioni** | ✅ | ✅ | ❌ | ❌ | -| **RAG** | ✅ | ✅ | ✅ | ✅ | -| **Workflow Builder** | ✅ | ✅ | ✅ | ✅ | -| **Deployment locale** | ✅ | ✅ | ✅ | ✅ | +| **Caratteristiche** | **TEN Agent** | **Pipecat** | **LiveKit:KITT** | **Vapi.ai** | **DailyBots** | **Play.ai** | +|:----------------------------------------:|:-------:|:--------:|:-------------:|:----------------:|:----------------:|:----------------:| +| **Visione** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Ricco supporto TTS per diverse lingue**| ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Supporto Go per estensione** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Supporto C++ per estensione** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Supporto RAG** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Costruttore di flussi di lavoro per estensione** | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | +| **Ricco supporto LLM** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Supporto Python per estensione** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Open source** | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |

-

Rimani aggiornato

- -Prima di continuare, assicurati di mettere una stella al nostro repository e ricevere notifiche istantanee per tutte le nuove versioni! - -![TEN star us gif](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_the_repo_confetti_higher_quality.gif?raw=true)
-

Unisciti alla community

+

Unisciti alla Comunità

-- [Discord](https://discord.gg/VnPftUzAMJ): Ideale per condividere le tue applicazioni e interagire con la community. -- [GitHub Discussion](https://github.com/TEN-framework/astra.ai/discussions): Perfetto per fornire feedback e fare domande. -- [GitHub Issues](https://github.com/TEN-framework/astra.ai/issues): Il migliore per segnalare bug e proporre nuove funzionalità. Consulta le nostre [linee guida per il contributo](./docs/code-of-conduct/contributing.md) per ulteriori dettagli. -- [X (precedentemente Twitter)](https://img.shields.io/twitter/follow/AstraAIAgent?logo=X&color=%20%23f5f5f5): Ottimo per condividere i tuoi agenti e interagire con la community. +- [Discord](https://discord.gg/VnPftUzAMJ): Ideale per condividere le tue applicazioni e interagire con la comunità. +- [Discussione GitHub](https://github.com/TEN-framework/ten-agent/discussions): Perfetto per fornire feedback e porre domande. +- [Problemi GitHub](https://github.com/TEN-framework/ten-agent/issues): Ottimo per segnalare bug e proporre nuove funzionalità. Consulta le nostre [linee guida per i contributi](./docs/code-of-conduct/contributing.md) per maggiori dettagli. +- [X (ex Twitter)](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5): Ottimo per condividere i tuoi agenti e interagire con la comunità.
-

Contributori al codice

+

Contributori del Codice

-[![TEN](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)
-

Linee guida per il contributo

+

Linee Guida per i Contributi

-I contributi sono benvenuti! Leggi prima le [linee guida per il contributo](./docs/code-of-conduct/contributing.md). +I contributi sono benvenuti! Si prega di leggere le [linee guida per i contributi](./docs/code-of-conduct/contributing.md) prima.

Licenza

-Questo progetto è concesso in licenza con licenza Apache 2.0 - consulta il file [LICENSE](LICENSE) per ulteriori dettagli. +Questo progetto è concesso in licenza sotto la Licenza Apache 2.0 - vedi il file [LICENSE](LICENSE) per i dettagli. diff --git a/docs/readmes/README-KR.md b/docs/readmes/README-KR.md index 859666f4..2922be2c 100644 --- a/docs/readmes/README-KR.md +++ b/docs/readmes/README-KR.md @@ -1,163 +1,196 @@ -![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) +[![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/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) +[![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 +README in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano -[문서](https://astra-9.gitbook.io/ten-platform) +[Getting Started](https://doc.theten.ai/ten-agent/getting_started)   •   -[시작하기](https://doc.theten.ai/getting-started/quickstart) +[Create Extensions](https://doc.theten.ai/ten-agent/create_a_hello_world_extension)   •   -[튜토리얼](https://doc.theten.ai/getting-started/create-a-hello-world-extension) +[TEN Framework Repository](https://github.com/TEN-framework/ten_framework) + +
+**TEN Agent**, powered by the world’s first real-time multimodal framework. It is open-source, with the ability to speak, see, and access a knowledge base. By taking advantage of TEN Framework, TEN Agent has the following features: + +1. **High-Performance Real-Time Multimodal Interactions**: +Offers high-performance, low-latency solutions for complex audio-visual AI applications. + +2. **Multi-Language and Multi-Platform Support** : +Supports extension development in C++, Go, Python, etc. Runs on Windows, Mac, Linux, and mobile devices. + +3. **Edge-Cloud Integration**: +Flexibly combines edge and cloud-deployed extensions, balancing privacy, cost, and performance. + +4. **Flexibility Beyond Model Limitations**: +Easily build complex AI applications through simple drag-and-drop programming, integrating audio-visual tools, databases, RAG, and more. + +5. **Real-Time Agent State Management**: +Manages and adjusts agent behavior in real-time for dynamic responsiveness. +
-

Astra Agent

+

Stay Tuned

-[보이스 에이전트: Astra](https://theastra.ai) +Before we get started, be sure to star our repository and get instant notifications for all new releases! -Astra는 TEN을 통해 구동되는 보이스 에이전트로, 직관적이고 원활한 대화 상호작용을 만들어내는 능력을 보여줍니다. +![TEN star us gif](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_us_2.gif?raw=true) -[![Astra 쇼케이스](https://github.com/TEN-framework/docs/blob/main/assets/gif/astra_voice_agent.gif?raw=true)](https://theastra.ai)
-

로컬에서 보이스 에이전트 구축하는 방법 +

TEN Agent

-### 전제 조건 +[TEN Agent](https://agent.theten.ai) -#### 키 -- Agora 앱 ID 및 앱 인증서([여기서 방법 읽기](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web)) -- Azure의 [음성-텍스트](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) 및 [텍스트-음성](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) API 키 -- [OpenAI](https://openai.com/index/openai-api/) API 키 +TEN Agent is a multimodal agent powered by [ TEN ](https://theten.ai), demonstrating its capabilities in speech, vision, and reasoning through RAG from local documentation. + +[![Showcase TEN multimodal agent](https://github.com/TEN-framework/docs/blob/main/assets/gif/features.gif?raw=true)](https://agent.theten.ai) +
+

How to build TEN Agent locally -#### 설치 +### Prerequisites + +#### Keys +- Agora [ App ID ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) and [ App Certificate ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project)(certificate is not required) +- Azure [SST](https://azure.microsoft.com/en-us/products/ai-services/speech-to-text) and [TTS](https://azure.microsoft.com/en-us/products/ai-services/text-to-speech) API keys (feel free to use another provider) +- [OpenAI](https://openai.com/index/openai-api/) API key + +#### Installation - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) - [Node.js(LTS) v18](https://nodejs.org/en) -#### 최소 시스템 요구 사항 - - CPU >= 2 코어 +#### Minimum system requirements + - CPU >= 2 Core - RAM >= 4 GB -#### Apple Silicon에서의 Docker 설정 -Apple Silicon을 사용하는 경우 Docker의 "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" 옵션을 선택 해제해야 합니다. 그렇지 않으면 서버가 작동하지 않습니다. +#### Docker setting on Apple Silicon +You will need to uncheck "Use Rosetta for x86_64/amd64 emulation on Apple Silicon" option for Docker if you are on Apple Silicon, otherwise the server is not going to work. + +![Docker Setting](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true) -![Docker 설정](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true) +### Next step -### 다음 단계 +#### 1. Modify config files +In the root of the project, use `cp` command to create `.env` from the example. -#### 1. 설정 파일 수정 -프로젝트의 루트에서 `cp` 명령어를 사용하여 예시에서 `.env` 파일을 생성하세요. +It will be used to store information for `docker compose` later. ```bash cp ./.env.example ./.env ``` -#### 2. API 키 설정 -`.env` 파일을 열고 키와 지역을 입력하세요. 다른 확장 기능을 사용하려면 이곳에서 선택할 수 있습니다: - -``` +#### 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`: +```bash # Agora App ID and Agora App Certificate -# required: this variable must be set AGORA_APP_ID= +# Leave empty unless you have enabled the certificate within the Agora account. 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. 에이전트 개발 컨테이너 시작 -같은 디렉토리에서 `docker` 명령어를 실행하여 컨테이너를 구성합니다: +#### 3. Start agent development 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. 에이전트 빌드 및 서버 시작 -별도의 터미널 창을 열고, 에이전트를 빌드하고 서버를 시작합니다: +#### 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 ``` -### 완료 및 검증 🎉 - -#### Astra 음성 에이전트 -브라우저에서 localhost:3000을 열어 Astra 음성 에이전트를 테스트하세요. +### Finish and verify 🎉 -#### 그래프 디자이너 +#### TEN Agent +Open up http://localhost:3000 in browser to play and test the TEN Agent. -다른 탭을 열어 localhost:3001로 이동하고, 그래프 디자이너를 사용하여 확장 기능의 흐름과 속성을 편집하세요. +#### Graph Designer +Open up another tab go to http://localhost:3001, and use Graph Designer to create, connect and edit extensions on canvas. ![TEN Graph Designer](https://github.com/TEN-framework/docs/blob/main/assets/gif/graph_designer.gif?raw=true)
-

TEN 플랫폼

- -이제 첫 번째 AI 에이전트를 만들었으니, 여기서 창의력이 멈추지 않습니다. 더 놀라운 에이전트를 개발하려면 TEN 서비스가 내부적으로 어떻게 작동하는지에 대한 고급 이해가 필요합니다. [TEN 플랫폼 문서](https://astra-9.gitbook.io/ten-platform)를 참조하십시오. +

TEN Agent Comparison

-
-

연락을 유지하세요

+
-더 깊이 들어가기 전에, 꼭 우리 저장소에 별표를 표시하고 모든 새 릴리스에 대한 즉각적인 알림을 받으세요! +| **Features** | **TEN Agent** | **Pipecat** | **LiveKit:KITT** | **Vapi.ai** | **DailyBots** | **Play.ai** | +|:----------------------------------------:|:-------:|:--------:|:-------------:|:----------------:|:----------------:|:----------------:| +| **Vision** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Rich TTS Support for different languages** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Go support for extension** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **C++ support for extension** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **RAG support** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | +| **Workflow builder for extension** | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | +| **Rich LLM Support** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Python support for extension** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **Open source** | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | -![TEN 별표 표시 gif](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_the_repo_confetti_higher_quality.gif?raw=true) +

-

커뮤니티 가입

+
+

Join Community

+ - [Discord](https://discord.gg/VnPftUzAMJ): Ideal for sharing your applications and engaging with the community. -- [GitHub Discussion](https://github.com/TEN-framework/astra.ai/discussions): Perfect for providing feedback and asking questions. -- [GitHub Issues](https://github.com/TEN-framework/astra.ai/issues): Best for reporting bugs and proposing new features. Refer to our [contribution guidelines](./docs/code-of-conduct/contributing.md) for more details. -- [X (formerly Twitter)](https://img.shields.io/twitter/follow/AstraAIAgent?logo=X&color=%20%23f5f5f5): Great for sharing your agents and interacting with the community. +- [GitHub Discussion](https://github.com/TEN-framework/ten-agent/discussions): Perfect for providing feedback and asking questions. +- [GitHub Issues](https://github.com/TEN-framework/ten-agent/issues): Best for reporting bugs and proposing new features. Refer to our [contribution guidelines](./docs/code-of-conduct/contributing.md) for more details. +- [X (formerly Twitter)](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5): Great for sharing your agents and interacting with the community.
-

코드 기여자

+

Code Contributors

-[![TEN](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)
-

기여 가이드라인

+

Contribution Guidelines

-기여는 환영합니다! 먼저 [기여 가이드라인](CONTRIBUTING.md)을 읽어주세요. +Contributions are welcome! Please read the [contribution guidelines](./docs/code-of-conduct/contributing.md) first.
-

라이선스

- -이 프로젝트는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하십시오. +

License

+This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.