Skip to content

Latest commit

 

History

History
487 lines (297 loc) · 23.1 KB

File metadata and controls

487 lines (297 loc) · 23.1 KB

Tabla de contenidos

Tabla de contenido


👋 Comenzando y Unirse a la Comunidad TEN

TEN Agent es un agente de voz conversacional IA potenciado por TEN, integrando DeepSeek, Gemini, OpenAI, RTC, y hardware como ESP32. Habilita capacidades IA en tiempo real como vista, escucha, y habla, y es completamente compatible con plataformas como Dify and Coze.


Canal de la comunidad Propósito
Discord TEN Community Únete a nuestra comunidad de Discord para conectar con desarrolladores, compartir proyectos y obtener ayuda
Follow on X Sigue a TEN Framework en X para actualizaciones y anuncios
WeChat Únete a nuestro grupo de WeChat para discusiones en la comunidad China

Important

Destaca nuestro Repositorio ⭐️

Obtén notificaciones instantáneas para nuevos lanzamientos y actualizaciones. Tu apoyo nos ayuda a crecer y a mejorar TEN Agent!


TEN star us gif

Historial de estrellas


✨ Funciones

1️⃣ 🔥 Ten Agent + Trulience

Construye avatares AI atractivos con TEN Agent usando la colección diversa de opciones de avatares gratuitos de Trulience. Para ponerlo en funcionamiento, solo necesitas 2 pasos:

  1. Sigue el README para terminar la configuración y ejecutar el Playground en localhost:3000
  2. Ingresa el ID del avatar y el token que obtienes de Trulience
TEN Agent + Trulience

TEN Agent with Trulience

TEN es un marco muy versátil. Dicho esto, TEN Agent es compatible con DeepSeek R1, ¡intenta experimentar conversaciones en tiempo real con DeepSeek R1!

TEN Agent ahora funciona en la placa de desarrollo Espressif ESP32-S3 Korvo V3, una excelente manera de integrar la comunicación en tiempo real con LLM en hardware.

4️⃣ TEN Agent + Gemini Multimodal Live API

Prueba Google Gemini Multimodal Live API con capacidades de visión en tiempo real y detección de pantalla compartida en tiempo real, es una extensión lista para usar, junto con herramientas poderosas como Weather Check y Web Search integradas perfectamente en TEN Agent.

Gemini 2.0 Multimodal Live API

Usecases

5️⃣ TEN Agent + Storyteller + Image Generator

Describe un tema y pide a TEN Agent que te cuente una historia mientras también genera imágenes de la historia para proporcionar una experiencia más inmersiva para los niños.

Storyteller + Image Generator

Usecases

6️⃣ TEN Agent + Dify

TEN Agent + Dify

TEN ofrece un gran soporte para mejorar la experiencia interactiva en tiempo real en otras plataformas LLM también, consulta los documentos para más información.

TEN Agent + Dify with RAG

Dify with RAG

7️⃣ TEN Agent + Coze

TEN Agent + Coze

TEN se integra a la perfección con la plataforma Coze para mejorar las experiencias interactivas en tiempo real. Consulta nuestra documentación para saber cómo aprovechar estas potentes integraciones.


💡 TEN Agent Usecases

Usecases


🔌 Extensions listas para usar

Ready-to-use Extensions


🎮 Playground de TEN Agent

🅰️ Ejecutar Playground en localhost (Entorno local)

Paso 1 ⓵ - Requisitos previos

Category Requirements
Claves • Agora App ID y App Certificate (minutos gratuitos cada mes)
OpenAI clave API (cualquier LLM compatible con OpenAI)
Deepgram ASR (créditos gratuitos disponibles con el registro)
Elevenlabs TTS (free credits available with signup)
Instalación Docker / Docker Compose
Node.js(LTS) v18
Requisitos mínimos del sistema • CPU >= 2 Núcleos
• RAM >= 4 GB

[!NOTA]

macOS: Configuración de Docker en Apple Silicon

Desmarque "Use Rosetta for x86/amd64 emulation" en la configuración de Docker. Esto puede resultar en tiempos de construcción más lentos en ARM, pero el rendimiento será normal cuando se despliegue en servidores x64.


Paso ⓶ - Construir el agente en Máquina virtual

1. Clonar el repositorio y crear el archivo .env desde .env.example
cp ./.env.example ./.env
2. Configurar Agora App ID y App Certificate en .env
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
3. Iniciar contenedores de desarrollo de agente
docker compose up -d
4. Ingresar al contenedor
docker exec -it ten_agent_dev bash
5. Construir al agente con el graph por defecto ( ~5min - ~8min)

Revisar la carpeta /examples para más ejemplos

task use
6. Iniciar el servidor web
task run

Step ⓷ - Personalizar tu agente

  1. Abre localhost:3000 y selecciona un tipo de gráfico
  2. Elije un módulo correspondiente
  3. Selecciona una extensión y configura sus ajustes de clave API
Module Picker Example

Module Picker Example

Ahora, hemos configurado exitosamente el playground. Esto es solo el comienzo de TEN Agent. Hay muchas formas diferentes de explorar y utilizar TEN Agent. Para obtener más información, consulta la documentación.


🅱️ Ejecutar Playground en espacio de código(no docker)

GitHub ofrece un espacio de código gratis para cada repositorio, puedes ejecutar el playground en el espacio de código sin usar Docker. También, La velocidad del espacio de código es mucho más rápida que localhost.

Revisa esta guía para más detalles


🎥 Ejecutar Demo de TEN Agent

El Playground y el servidor Demo tienen diferentes propósitos, en pocas palabras, piensa que el Playground es para que personalices a tu agente, y el demo es para que despliegues a tu agente.

Check out this guide for more details.


🛳️ Auto hospedaje

🅰️ 🐳 Despliegue con Docker

Una vez que hayas personalizado a tu agente (ya sea usando playground o editando property.json directamente), puedes desplegarlo creando una imagen de Docker de lanzamiento para tu servicio. Lee la Guía de despliegue para información detallada acerca del despliegue.


🅱️ Despliegue con otros servicios

Próximamente...


🏗️ Arquitectura de TEN Agent

1️⃣ TEN Agent App: Aplicación central que administra extensiones y flujo de datos basado en configuración de gráficos.

2️⃣ Dev Server: port:49480- Servidor local para propósitos de desarrollo.

3️⃣ Web Server: port:8080- Servidor Golang que maneja peticiones HTTP y gestión de procesos del agente

4️⃣ Front-end UI:

  • port:3000 Playground - Para personalizar y probar la configuración de tu agente.
  • port:3002 Demo - Para desplegar tu agente sin selector de módulo.

Components Diagram


🌍 Ecosistema de TEN Framework

🏚️ TEN Framework
TEN, un framework de agente IA para crear varios agentes IA los cuales soportan conversaciones en tiempo real.

🎙️ TEN Agent
TEN Agent es un agente de voz conversacional IA potenciado por TEN, integrando DeepSeek, Gemini, OpenAI, RTC, y hardware como ESP32. Habilita capacidades IA en tiempo real como vista, escucha, y habla, y es completamente compatible con plataformas como Dify and Coze..

🎨 TMAN Designer alpha
TMAN Designer es una opción que requiere poco o ningún código para creae un agente de voz atractivo. Con su interfaz de flujo de trabajo intuitiva, puedes crear cosas fácilmente. Incluye tiempo de ejecución, temas oscuros/claros, editores y terminales integrados.

📒 TEN Portal
El sitio oficial de TEN framework, contiene documentación, blog y demostraciones.


🤝 Contribuciones

¡Le damos la bienvenida a cualquier forma de colaboración de código abierto! Ya sea que estés arreglando errores, añadiendo características, mejorando documentación o compartiendo ideas - tu contribución ayuda a avanzar en herramientas personalizadas de IA. Revisa nuestros GitHub Issues y Proyectos para encontrar maneras de contribuir y mostrar tus habilidades. ¡Juntos, podemos construir algo sorprendente!

Tip

Bienvenidos todos los tipos de contribuciones 🙏

¡Únete a nosotros para mejorar TEN! Cada contribución hace la diferencia. desde código hasta documentación. ¡Comparte tus proyectos de TEN Agent en redes sociales para inspirar a otros!

Conecta con el mantenedor de TEN @cyfyifanchen en GitHub y @elliotchen100 en 𝕏 para actualizaciones del proyecto, discusiones y oportunidades de colaboración.

Contribuyentes de Código

TEN

Directrices de Contribución

¡Las contribuciones son bienvenidas! Por favor, lee primero las directrices de contribución.

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0.