|
| 1 | + |
| 2 | +<div align="center"> |
| 3 | + |
| 4 | +[](https://twitter.com/intent/follow?screen_name=AstraAIAgent) |
| 5 | + |
| 6 | +[](https://github.com/TEN-framework/astra.ai/discussions/) |
| 7 | +[](https://github.com/TEN-framework/astra.ai/graphs/commit-activity) |
| 8 | +[](https://github.com/TEN-framework/ASTRA.ai/issues) |
| 9 | +[](https://github.com/TEN-framework/ASTRA.ai/pulls) |
| 10 | +[](https://github.com/TEN-framework/ASTRA.ai/blob/main/LICENSE) |
| 11 | + |
| 12 | +[](https://discord.gg/VnPftUzAMJ) |
| 13 | + |
| 14 | +[](https://GitHub.com/TEN-framework/astra.ai/watchers/?WT.mc_id=academic-105485-koreyst) |
| 15 | +[](https://GitHub.com/TEN-framework/astra.ai/network/?WT.mc_id=academic-105485-koreyst) |
| 16 | +[](https://GitHub.com/TEN-framework/astra.ai/stargazers/?WT.mc_id=academic-105485-koreyst) |
| 17 | + |
| 18 | +<a href="https://github.com/TEN-framework/ASTRA.ai/blob/main/README.md"><img alt="README in English" src="https://img.shields.io/badge/English-lightgrey"></a> |
| 19 | +<a href="https://github.com/ten-framework/astra.ai/blob/main/docs/readmes/README-CN.md"><img alt="简体中文操作指南" src="https://img.shields.io/badge/简体中文-lightgrey"></a> |
| 20 | +<a href="https://github.com/ten-framework/astra.ai/blob/main/docs/readmes/README-JP.md"><img alt="日本語のREADME" src="https://img.shields.io/badge/日本語-lightgrey"></a> |
| 21 | +<a href="https://github.com/ten-framework/astra.ai/blob/main/docs/readmes/README-KR.md"><img alt="README in 한국어" src="https://img.shields.io/badge/한국어-lightgrey"></a> |
| 22 | +<a href="https://github.com/ten-framework/astra.ai/blob/main/docs/readmes/README-ES.md"><img alt="README en Español" src="https://img.shields.io/badge/Español-lightgrey"></a> |
| 23 | +<a href="https://github.com/ten-framework/astra.ai/blob/main/docs/readmes/README-FR.md"><img alt="README en Français" src="https://img.shields.io/badge/Français-lightgrey"></a> |
| 24 | +<a href="https://github.com/ten-framework/astra.ai/blob/main/docs/readmes/README-IT.md"><img alt="README in Italiano" src="https://img.shields.io/badge/Italiano-lightgrey"></a> |
| 25 | + |
| 26 | + |
| 27 | +[Documentación](https://doc.theten.ai) |
| 28 | +<span> • </span> |
| 29 | +[Empezando](https://doc.theten.ai/getting-started/quickstart) |
| 30 | +<span> • </span> |
| 31 | +[Tutoriales](https://doc.theten.ai/getting-started/create-a-hello-world-extension) |
| 32 | + |
| 33 | + |
| 34 | +</div> |
| 35 | + |
| 36 | +<br> |
| 37 | +<h2>Astra - un agente multimodal</h2> |
| 38 | + |
| 39 | +[Astra multimodal agent](https://theastra.ai) |
| 40 | + |
| 41 | +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. |
| 42 | + |
| 43 | +[](https://theastra.ai) |
| 44 | +<br> |
| 45 | +<h2>Cómo construir Astra localmente |
| 46 | + |
| 47 | +### Requisitos previos |
| 48 | + |
| 49 | +#### Claves |
| 50 | +- 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)) |
| 51 | +- 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 |
| 52 | +- Clave de API de [OpenAI](https://openai.com/index/openai-api/) |
| 53 | + |
| 54 | +#### Instalación |
| 55 | + - [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/) |
| 56 | + - [Node.js(LTS) v18](https://nodejs.org/en) |
| 57 | + |
| 58 | +#### Requisitos mínimos del sistema |
| 59 | + - CPU >= 2 núcleos |
| 60 | + - RAM >= 4 GB |
| 61 | + |
| 62 | +#### Configuración de Docker en Apple Silicon |
| 63 | +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á. |
| 64 | + |
| 65 | + |
| 66 | + |
| 67 | +### Siguiente paso |
| 68 | + |
| 69 | +#### 1. Modificar archivos de configuración |
| 70 | +En la raíz del proyecto, usa el siguiente comando para crear `.env` y `./agents/property.json` a partir de los ejemplos. |
| 71 | + |
| 72 | +Se utilizarán para almacenar información para `docker compose` más adelante. |
| 73 | +```bash |
| 74 | +cp ./.env.example ./.env |
| 75 | +cp ./agents/property.json.example ./agents/property.json |
| 76 | +``` |
| 77 | + |
| 78 | +#### 2. Configurar claves de API |
| 79 | +Abre el archivo `.env` y completa las secciones `keys` y `regions`. Aquí también puedes elegir usar diferentes `extensions`: |
| 80 | +```bash |
| 81 | +# Agora App ID y Agora App Certificate |
| 82 | +AGORA_APP_ID= |
| 83 | +# Deja en blanco a menos que hayas habilitado el certificado dentro de la cuenta de Agora. |
| 84 | +AGORA_APP_CERTIFICATE= |
| 85 | + |
| 86 | +# Clave y región de Azure STT |
| 87 | +AZURE_STT_KEY= |
| 88 | +AZURE_STT_REGION= |
| 89 | + |
| 90 | +# Clave y región de Azure TTS |
| 91 | +AZURE_TTS_KEY= |
| 92 | +AZURE_TTS_REGION= |
| 93 | + |
| 94 | +# Clave de API de OpenAI |
| 95 | +OPENAI_API_KEY= |
| 96 | +``` |
| 97 | + |
| 98 | +#### 3. Iniciar contenedores de desarrollo del agente |
| 99 | +En el mismo directorio, ejecuta el comando `docker compose up` para componer los contenedores: |
| 100 | +```bash |
| 101 | +docker compose up |
| 102 | +``` |
| 103 | + |
| 104 | +#### 4. Ingresar al contenedor y construir el agente |
| 105 | +Abre una ventana de terminal separada, ingresa al contenedor y construye el agente: |
| 106 | +```bash |
| 107 | +docker exec -it astra_agents_dev bash |
| 108 | +make build |
| 109 | +``` |
| 110 | + |
| 111 | +#### 5. Iniciar el servidor |
| 112 | +Una vez que se haya completado la construcción, ejecuta `make run-server` en el puerto `8080`: |
| 113 | +```bash |
| 114 | +make run-server |
| 115 | +``` |
| 116 | + |
| 117 | +### ¡Finaliza y verifica 🎉 |
| 118 | + |
| 119 | +#### Agente multimodal Astra |
| 120 | +Abre http://localhost:3000 en el navegador para probar el agente multimodal Astra. |
| 121 | + |
| 122 | +#### Diseñador de gráficos |
| 123 | + |
| 124 | +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. |
| 125 | + |
| 126 | + |
| 127 | + |
| 128 | +<br> |
| 129 | +<h2>Plataforma TEN</h2> |
| 130 | + |
| 131 | +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). |
| 132 | + |
| 133 | +<br> |
| 134 | +<h2>Comparación de características de TEN</h2> |
| 135 | + |
| 136 | +<div align="center"> |
| 137 | + |
| 138 | +| **Características** | **TEN** | **Dify** | **LangChain** | **Flowise** | |
| 139 | +|:----------------------------------------:|:-------:|:--------:|:-------------:|:-----------:| |
| 140 | +| **Agente multimodal de código abierto** | ✅ | ❌ | ❌ | ❌ | |
| 141 | +| **Python, Go y C++ para extensiones** | ✅ | ❌ | ❌ | ❌ | |
| 142 | +| **Gestor de paquetes todo en uno** | ✅ | ❌ | ❌ | ❌ | |
| 143 | +| **Transporte RTC** | ✅ | ❌ | ❌ | ❌ | |
| 144 | +| **Tienda de extensiones** | ✅ | ✅ | ❌ | ❌ | |
| 145 | +| **RAG** | ✅ | ✅ | ✅ | ✅ | |
| 146 | +| **Constructor de flujo de trabajo** | ✅ | ✅ | ✅ | ✅ | |
| 147 | +| **Implementación local** | ✅ | ✅ | ✅ | ✅ | |
| 148 | + |
| 149 | +</div> |
| 150 | + |
| 151 | +<br> |
| 152 | +<h2>Mantente informado</h2> |
| 153 | + |
| 154 | +Antes de continuar, ¡asegúrate de marcar nuestro repositorio como favorito y recibir notificaciones instantáneas sobre todas las nuevas versiones! |
| 155 | + |
| 156 | + |
| 157 | + |
| 158 | +<br> |
| 159 | +<h2>Únete a la comunidad</h2> |
| 160 | + |
| 161 | +- [Discord](https://discord.gg/VnPftUzAMJ): Ideal para compartir tus aplicaciones y participar en la comunidad. |
| 162 | +- [Discusión en GitHub](https://github.com/TEN-framework/astra.ai/discussions): Perfecto para brindar comentarios y hacer preguntas. |
| 163 | +- [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. |
| 164 | +- [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. |
| 165 | + |
| 166 | +<br> |
| 167 | +<h2>Contribuyentes de código</h2> |
| 168 | + |
| 169 | +[](https://github.com/TEN-framework/astra.ai/graphs/contributors) |
| 170 | + |
| 171 | +<br> |
| 172 | +<h2>Pautas de contribución</h2> |
| 173 | + |
| 174 | +¡Las contribuciones son bienvenidas! Por favor, lee primero las [pautas de contribución](./docs/code-of-conduct/contributing.md). |
| 175 | + |
| 176 | +<br> |
| 177 | +<h2>Licencia</h2> |
| 178 | + |
| 179 | +Este proyecto está licenciado bajo la Licencia Apache 2.0. Consulta el archivo [LICENSE](LICENSE) para obtener más detalles. |
| 180 | + |
0 commit comments