diff --git a/README.md b/README.md index ed4eaaa7..7d5f11f4 100644 --- a/README.md +++ b/README.md @@ -15,16 +15,20 @@ [![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 in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano + [Documentation](https://doc.theten.ai)   •   -[Getting Started](https://astra-9.gitbook.io/ten-platform/getting-started/quickstart) +[Getting Started](https://doc.theten.ai/getting-started/quickstart)   •   -[Tutorials](https://app.gitbook.com/o/we7IoLK5sA6RQzhItfkW/s/4KgjqM5ChU0dSGjTLZmG/~/changes/6/tutorials/how-to-build-extension-with-go) +[Tutorials](https://doc.theten.ai/getting-started/create-a-hello-world-extension) diff --git a/docs/readmes/README-CN.md b/docs/readmes/README-CN.md index 37053f80..d11efca4 100644 --- a/docs/readmes/README-CN.md +++ b/docs/readmes/README-CN.md @@ -16,19 +16,23 @@ [![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 in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano +
[文档](https://doc.theten.ai)   •   -[快速开始](https://astra-9.gitbook.io/ten-platform/getting-started/quickstart) +[快速开始](https://doc.theten.ai/getting-started/quickstart)   •   -[教程](https://app.gitbook.com/o/we7IoLK5sA6RQzhItfkW/s/4KgjqM5ChU0dSGjTLZmG/~/changes/6/tutorials/how-to-build-extension-with-go) +[教程](https://doc.theten.ai/getting-started/create-a-hello-world-extension)
diff --git a/docs/readmes/README-ES.md b/docs/readmes/README-ES.md new file mode 100644 index 00000000..e11c5412 --- /dev/null +++ b/docs/readmes/README-ES.md @@ -0,0 +1,180 @@ +![Astra banner image](https://github.com/TEN-framework/docs/blob/main/assets/imgs/astra-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) + +[![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) + +README in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano + + +[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) + + +
+ +
+

Astra - un agente multimodal

+ +[Astra multimodal agent](https://theastra.ai) + +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 Astra](https://github.com/TEN-framework/docs/blob/main/assets/gifs/astra-voice-agent.gif?raw=true)](https://theastra.ai) +
+

Cómo construir Astra localmente + +### Requisitos previos + +#### 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/) + +#### Instalación + - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) + - [Node.js(LTS) v18](https://nodejs.org/en) + +#### Requisitos mínimos del sistema + - CPU >= 2 núcleos + - 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á. + +![Configuración de Docker](https://github.com/TEN-framework/docs/blob/main/assets/gifs/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` y `./agents/property.json` a partir de los ejemplos. + +Se utilizarán para almacenar información para `docker compose` más adelante. +```bash +cp ./.env.example ./.env +cp ./agents/property.json.example ./agents/property.json +``` + +#### 2. Configurar claves de API +Abre el archivo `.env` y completa las secciones `keys` y `regions`. Aquí también puedes elegir usar diferentes `extensions`: +```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. +AGORA_APP_CERTIFICATE= + +# Clave y región de Azure STT +AZURE_STT_KEY= +AZURE_STT_REGION= + +# Clave y región de Azure TTS +AZURE_TTS_KEY= +AZURE_TTS_REGION= + +# Clave de API de OpenAI +OPENAI_API_KEY= +``` + +#### 3. Iniciar contenedores de desarrollo del agente +En el mismo directorio, ejecuta el comando `docker compose up` para componer los contenedores: +```bash +docker compose up +``` + +#### 4. Ingresar al contenedor y construir el agente +Abre una ventana de terminal separada, ingresa 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`: +```bash +make run-server +``` + +### ¡Finaliza y verifica 🎉 + +#### Agente multimodal Astra +Abre http://localhost:3000 en el navegador para probar el agente multimodal Astra. + +#### Diseñador de gráficos + +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 TEN](https://github.com/TEN-framework/docs/blob/main/assets/gifs/graph-designer.gif?raw=true) + +
+

Plataforma TEN

+ +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). + +
+

Comparación de características de TEN

+ +
+ +| **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** | ✅ | ✅ | ✅ | ✅ | + +
+ +
+

Mantente informado

+ +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/gifs/star-the-repo-confetti-higher-quality.gif?raw=true) + +
+

Únete a la comunidad

+ +- [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. + +
+

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

+ +¡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. + diff --git a/docs/readmes/README-FR.md b/docs/readmes/README-FR.md new file mode 100644 index 00000000..d1292cba --- /dev/null +++ b/docs/readmes/README-FR.md @@ -0,0 +1,177 @@ +![Astra banner image](https://github.com/TEN-framework/docs/blob/main/assets/imgs/astra-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) + +[![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) + +README in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano + + +[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) + +
+ +
+

Astra - un agent multimodal

+ +[Agent multimodal Astra](https://theastra.ai) + +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. + +[![Présentation de l'agent multimodal Astra](https://github.com/TEN-framework/docs/blob/main/assets/gifs/astra-voice-agent.gif?raw=true)](https://theastra.ai) +
+

Comment construire Astra 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/) + +#### Installation + - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) + - [Node.js(LTS) v18](https://nodejs.org/en) + +#### Configuration système minimale requise + - 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. + +![Paramètres Docker](https://github.com/TEN-framework/docs/blob/main/assets/gifs/docker-setting.gif?raw=true) + +### Étape suivante + +#### 1. Modifier les fichiers de configuration +À la racine du projet, utilisez la commande suivante pour créer les fichiers `.env` et `./agents/property.json` à partir des exemples. + +Ils seront utilisés pour stocker les informations pour `docker compose` ultérieurement. +```bash +cp ./.env.example ./.env +cp ./agents/property.json.example ./agents/property.json +``` + +#### 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` : +```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. +AGORA_APP_CERTIFICATE= + +# Clé et région Azure STT +AZURE_STT_KEY= +AZURE_STT_REGION= + +# Clé et région Azure TTS +AZURE_TTS_KEY= +AZURE_TTS_REGION= + +# Clé API OpenAI +OPENAI_API_KEY= +``` + +#### 3. Démarrer les conteneurs de développement de l'agent +Dans le même répertoire, exécutez la commande `docker compose up` pour composer les conteneurs : +```bash +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 : +```bash +docker exec -it astra_agents_dev bash +make build +``` + +#### 5. Démarrer le serveur +Une fois la construction terminée, exécutez `make run-server` sur le port `8080` : +```bash +make run-server +``` + +### Terminé et vérifié 🎉 + +#### Agent multimodal Astra +Ouvrez http://localhost:3000 dans votre navigateur pour tester l'agent multimodal Astra. + +#### 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 graphiques TEN](https://github.com/TEN-framework/docs/blob/main/assets/gifs/graph-designer.gif?raw=true) + +
+

Plateforme TEN

+ +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). + +
+

Comparaison des fonctionnalités TEN

+ +
+ +| **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** | ✅ | ✅ | ✅ | ✅ | + +
+ +
+

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/gifs/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é. + +
+

Contributeurs au code

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

Directives de contribution

+ +Les contributions sont les bienvenues ! Veuillez d'abord lire les [directives de contribution](./docs/code-of-conduct/contributing.md). + +
+

Licence

+ +Ce projet est sous licence Apache 2.0 - consultez le fichier [LICENSE](LICENSE) pour plus de détails. diff --git a/docs/readmes/README-IT.md b/docs/readmes/README-IT.md new file mode 100644 index 00000000..9cf0cf30 --- /dev/null +++ b/docs/readmes/README-IT.md @@ -0,0 +1,178 @@ +![Astra banner image](https://github.com/TEN-framework/docs/blob/main/assets/imgs/astra-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) + +[![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) + +README in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano + + +[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) + +
+ +
+

Astra - un agente multimodale

+ +[Astra agente multimodale](https://theastra.ai) + +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. + +[![Mostra Astra agente multimodale](https://github.com/TEN-framework/docs/blob/main/assets/gifs/astra-voice-agent.gif?raw=true)](https://theastra.ai) +
+

Come costruire Astra 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/) + +#### Installazione + - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) + - [Node.js(LTS) v18](https://nodejs.org/en) + +#### Requisiti minimi di sistema + - CPU >= 2 Core + - 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à. + +![Impostazione Docker](https://github.com/TEN-framework/docs/blob/main/assets/gifs/docker-setting.gif?raw=true) + +### Prossimo passo + +#### 1. Modifica dei file di configurazione +Nella root del progetto, utilizza il seguente comando per creare `.env` e `./agents/property.json` dagli esempi. + +Verranno utilizzati per memorizzare le informazioni per `docker compose` successivamente. +```bash +cp ./.env.example ./.env +cp ./agents/property.json.example ./agents/property.json +``` + +#### 2. Configurazione delle chiavi API +Apri il file `.env` e compila le sezioni `keys` e `regions`. Puoi anche scegliere di utilizzare diverse `extensions`: +```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. +AGORA_APP_CERTIFICATE= + +# Chiave e regione di Azure STT +AZURE_STT_KEY= +AZURE_STT_REGION= + +# Chiave e regione di Azure TTS +AZURE_TTS_KEY= +AZURE_TTS_REGION= + +# Chiave API di OpenAI +OPENAI_API_KEY= +``` + +#### 3. Avvia i container di sviluppo dell'agente +Nella stessa directory, esegui il comando `docker compose up` per comporre i container: +```bash +docker compose up +``` + +#### 4. Entra nel container e crea l'agente +Apri una finestra del terminale separata, entra nel container e crea 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`: +```bash +make run-server +``` + +### Completato e verifica 🎉 + +#### Astra agente multimodale +Apri http://localhost:3000 nel browser per testare Astra agente multimodale. + +#### 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. + +![TEN Graph Designer](https://github.com/TEN-framework/docs/blob/main/assets/gifs/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

+ +
+ +| **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** | ✅ | ✅ | ✅ | ✅ | + +
+ +
+

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/gifs/star-the-repo-confetti-higher-quality.gif?raw=true) + +
+

Unisciti alla community

+ +- [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. + +
+

Contributori al codice

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

Linee guida per il contributo

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

Licenza

+ +Questo progetto è concesso in licenza con licenza Apache 2.0 - consulta il file [LICENSE](LICENSE) per ulteriori dettagli. diff --git a/docs/readmes/README-JP.md b/docs/readmes/README-JP.md index a5148a14..c0bcbf43 100644 --- a/docs/readmes/README-JP.md +++ b/docs/readmes/README-JP.md @@ -16,19 +16,23 @@ [![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 in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano +
[ドキュメント](https://astra-9.gitbook.io/ten-platform)   •   -[クイックスタート](https://astra-9.gitbook.io/ten-platform/getting-started/quickstart) +[クイックスタート](https://doc.theten.ai/getting-started/quickstart)   •   -[チュートリアル](https://app.gitbook.com/o/we7IoLK5sA6RQzhItfkW/s/4KgjqM5ChU0dSGjTLZmG/~/changes/6/tutorials/how-to-build-extension-with-go) +[チュートリアル](https://doc.theten.ai/getting-started/create-a-hello-world-extension)
diff --git a/docs/readmes/README-KR.md b/docs/readmes/README-KR.md index fcf659ab..784ce535 100644 --- a/docs/readmes/README-KR.md +++ b/docs/readmes/README-KR.md @@ -15,16 +15,19 @@ [![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 in English +简体中文操作指南 +日本語のREADME +README in 한국어 +README en Español +README en Français +README in Italiano [문서](https://astra-9.gitbook.io/ten-platform)   •   -[시작하기](https://astra-9.gitbook.io/ten-platform/getting-started/quickstart) +[시작하기](https://doc.theten.ai/getting-started/quickstart)   •   -[튜토리얼](https://app.gitbook.com/o/we7IoLK5sA6RQzhItfkW/s/4KgjqM5ChU0dSGjTLZmG/~/changes/6/tutorials/how-to-build-extension-with-go) +[튜토리얼](https://doc.theten.ai/getting-started/create-a-hello-world-extension)