Skip to content

Latest commit

 

History

History
448 lines (281 loc) · 20.8 KB

File metadata and controls

448 lines (281 loc) · 20.8 KB

Tabla de Contenidos

Tabla de Contenidos


👋 Bienvenido a TEN

TEN es una colección de proyectos de código abierto para construir agentes de voz conversacionales multimodales en tiempo real. Incluye TEN Framework, TEN Turn Detection, TEN Agent, TMAN Designer y TEN Portal, todos completamente de código abierto. TEN VAD aún no es completamente de código abierto, pero está abierto para uso público.


Canal de Comunidad Propósito
Follow on X Sigue a TEN Framework en X para actualizaciones y anuncios
Follow on LinkedIn Sigue a TEN Framework en LinkedIn para actualizaciones y anuncios
Discord TEN Community Únete a nuestra comunidad Discord para conectar con desarrolladores
Hugging Face Space Únete a nuestra comunidad Hugging Face para explorar nuestros espacios y modelos
WeChat Únete a nuestro grupo de WeChat para discusiones de la comunidad china

Important

Dale una estrella a los repositorios TEN ⭐️

¡Recibe notificaciones instantáneas de nuevos lanzamientos y actualizaciones. Tu apoyo nos ayuda a crecer y mejorar TEN!


TEN star us gif


Historial de Estrellas


🎨 TMAN Designer

TMAN Designer

TMAN Designer

TMAN Designer es una opción de bajo código/sin código para crear agentes de voz con una interfaz de usuario de flujo de trabajo fácil de usar. Puede cargar aplicaciones y gráficos, e incluye un editor en línea, visor de registros y mucho más.

Consulta este blog para más detalles.


✨ Características

TEN Agent with Trulience

1️⃣ Avatar en Tiempo Real

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

  1. Sigue el README para completar la configuración y ejecución del Área de Pruebas
  2. Ingresa el ID del avatar y el token que obtienes de Trulience


TEN Agent with MCP servers

2️⃣ Voz en tiempo real con servidores MCP

TEN Agent ahora se integra perfectamente con servidores MCP, expandiendo sus capacidades de LLM. Para comenzar:

  1. Abre el Selector de Módulos en el Área de Pruebas
  2. Agrega la herramienta de servidor MCP para integración LLM
  3. Pega una URL de tu servidor MCP en la extensión
  4. Inicia una conversación en tiempo real con TEN Agent

Esta integración te permite aprovechar las diversas ofertas de servidores de MCP mientras mantienes las potentes habilidades conversacionales de TEN Agent.


esp32.mov

3️⃣ Comunicación en tiempo real con hardware

TEN Agent ahora se ejecuta 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.

Consulta la guía de integración para más detalles.


Real-time vision

4️⃣ Visión en tiempo real y detección de pantalla compartida

Prueba la API Multimodal en Vivo de Google Gemini con capacidades de visión en tiempo real y detección de pantalla compartida, es una extensión lista para usar, junto con potentes herramientas como Verificación del Clima y Búsqueda Web integradas perfectamente en TEN Agent.


TEN with other LLM platforms

5️⃣ TEN con otras plataformas LLM

TEN Agent + Dify

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


Image

6️⃣ StoryTeller - Generación de imágenes TEN

Experimenta la generación de imágenes en tiempo real con StoryTeller, es una extensión lista para usar, junto con potentes herramientas como Verificación del Clima y Búsqueda Web integradas perfectamente en TEN.


🛝 Inicio Rápido con el Área de Pruebas de TEN Agent

🅰️ Ejecutar Área de Pruebas en localhost

Paso ⓵ - Requisitos Previos

Categoría Requisitos
Claves • Agora ID de Aplicación y Certificado de Aplicación (minutos gratuitos cada mes)
OpenAI clave API (cualquier LLM compatible con OpenAI)
Deepgram ASR (créditos gratuitos disponibles al registrarse)
Elevenlabs TTS (créditos gratuitos disponibles al registrarse)
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

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


Paso ⓶ - Construir agente en VM

1. Clona el repositorio, cd a ai-agents y crea el archivo .env desde .env.example
cd ai_agent
cp ./.env.example ./.env
2. Configura el ID de Aplicación y Certificado de Agora en .env
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
3. Inicia los contenedores de desarrollo del agente
docker compose up -d
4. Entra al contenedor
docker exec -it ten_agent_dev bash
5. Construye el agente con el graph predeterminado ( ~5min - ~8min)

revisa la carpeta /examples para más ejemplos

# usa el agente predeterminado
task use

# o usa el agente demo
task use AGENT=agents/examples/demo
6. Inicia el servidor web
task run

Paso ⓷ - Personaliza tu agente con TMAN Designer

Customize your agent with TMAN Designer

  1. Abre localhost:49483.
  2. Carga el gráfico correspondiente desde el menú (por ejemplo, Asistente de Voz).
  3. Ingresa las claves API y establece las preferencias para cada extensión.
  4. Abre localhost:3000 para ver los cambios después de seleccionar Asistente de Voz.


🅱️ Ejecutar Área de Pruebas en Codespace(sin docker)

GitHub ofrece Codespace gratuito para cada repositorio, puedes ejecutar el área de pruebas en Codespace sin usar Docker. Además, la velocidad de Codespace es mucho más rápida que localhost.

Consulta esta guía para más detalles.


🛳️ Auto-hospedaje de TEN Agent

🅰️ 🐳 Despliegue con Docker

Una vez que hayas personalizado tu agente (ya sea usando el TMAN Manager, el Área de Pruebas, o editando property.json directamente), puedes desplegarlo creando una imagen Docker de lanzamiento para tu servicio.

Lee la Guía de Despliegue para información detallada sobre el despliegue.


🅱️ Despliegue con otros servicios en la nube

próximamente


🌏 Ecosistema TEN Framework

Proyecto Vista Previa
🏚️ TEN Framework
TEN es un framework de código abierto para IA conversacional multimodal en tiempo real.

️🔂 TEN Turn Detection
TEN es para comunicación de diálogo full-duplex.

🔉 TEN VAD
TEN VAD es un detector de actividad de voz (VAD) de transmisión de baja latencia, ligero y de alto rendimiento.

🎙️ TEN Agent
TEN Agent es una demostración de TEN Framework.

🎨 TMAN Designer
TMAN Designer es una opción de bajo código/sin código para crear un agente de voz con una interfaz de usuario de flujo de trabajo fácil de usar.

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



❓ Hacer Preguntas

Ask DeepWiki

La mayoría de las preguntas pueden ser respondidas usando DeepWiki, es rápido, intuitivo de usar y soporta múltiples idiomas.

🥰 Contribuir

¡Bienvenimos todas las formas de colaboración de código abierto! Ya sea que estés corrigiendo errores, agregando características, mejorando la documentación o compartiendo ideas - tus contribuciones ayudan a avanzar en las herramientas de IA personalizadas. ¡Revisa nuestros Issues y Proyectos de GitHub para encontrar formas de contribuir y mostrar tus habilidades. Juntos, podemos construir algo increíble!


Tip

Bienvenimos todo tipo de contribuciones 🙏

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

Conéctate con uno de los mantenedores de TEN @elliotchen100 en 𝕏 o @cyfyifanchen en GitHub para actualizaciones del proyecto, discusiones y oportunidades de colaboración.


Contribuidores de Código

TEN

Guía de Contribución

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

Licencia

  1. Todo el framework TEN (excepto las carpetas explícitamente listadas a continuación) se publica bajo la Licencia Apache, Versión 2.0, con restricciones adicionales. Para más detalles, consulta el archivo LICENSE ubicado en el directorio raíz del framework TEN.

  2. Los componentes dentro del directorio packages se publican bajo la Licencia Apache, Versión 2.0. Para más detalles, consulta el archivo LICENSE ubicado en el directorio raíz de cada paquete.

  3. Las bibliotecas de terceros utilizadas por el framework TEN están listadas y descritas en detalle. Para más información, consulta la carpeta third_party.