![TEN Agent banner](https://github.com/TEN-framework/docs/blob/main/assets/jpg/banner.jpg?raw=true)

<div align="center">

[![Seguir en X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=TenFramework)
[![Publicaciones de discusión](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%20closed&labelColor=green&color=green)](https://github.com/TEN-framework/ten-agent/issues)
[![PRs Bienvenidos](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ten-agent/pulls)
[![Licencia GitHub](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 Comunidad TEN](https://dcbadge.vercel.app/api/server/VnPftUzAMJ)](https://discord.gg/VnPftUzAMJ)

<a href="https://trendshift.io/repositories/11978" target="_blank"><img src="https://trendshift.io/api/badge/repositories/11978" alt="TEN-framework%2FTEN-Agent | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

[![Observadores 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)
[![Estrellas 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)

<a href="https://github.com/TEN-framework/ten-agent/blob/main/README.md"><img alt="README in English" src="https://img.shields.io/badge/English-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-CN.md"><img alt="简体中文操作指南" src="https://img.shields.io/badge/简体中文-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-JP.md"><img alt="日本語のREADME" src="https://img.shields.io/badge/日本語-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-KR.md"><img alt="README in 한국어" src="https://img.shields.io/badge/한국어-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-ES.md"><img alt="README en Español" src="https://img.shields.io/badge/Español-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-FR.md"><img alt="README en Français" src="https://img.shields.io/badge/Français-lightgrey"></a>
<a href="https://github.com/ten-framework/ten-agent/blob/main/docs/readmes/README-IT.md"><img alt="README in Italiano" src="https://img.shields.io/badge/Italiano-lightgrey"></a>

[Comenzar](https://doc.theten.ai/ten-agent/getting_started)
<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
[Crear Extensiones](https://doc.theten.ai/ten-agent/create_a_hello_world_extension)
<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
[Repositorio TEN Framework](https://github.com/TEN-framework/ten_framework)

</div>

<br>
<h2>🎉 TEN Agent con API en Tiempo Real de OpenAI y RTC</h2>

Prueba la API en Tiempo Real de OpenAI, **Verificación del Clima** y **Búsqueda Web** en [agent.theten.ai](https://agent.theten.ai).

Combinando la API en Tiempo Real de OpenAI para una latencia ultra baja con la supresión de ruido AI de RTC asegura interacciones suaves y de alta calidad. Además, la integración perfecta de herramientas de clima y noticias hace que TEN Agent sea aún más versátil.

![TEN Agent con API en Tiempo Real de OpenAI y RTC](https://github.com/TEN-framework/docs/blob/main/assets/gif/weather-and-news.gif?raw=true)

<br>
<h2>Casos de Uso de TEN Agent</h2>

![Casos de Uso](https://github.com/TEN-framework/docs/blob/main/assets/jpg/usecases.jpg?raw=true)

<br>
<h2>Extensiones Listas para Usar</h2>

![Extensiones Listas para Usar](https://github.com/TEN-framework/docs/blob/main/assets/jpg/extensions.jpg?raw=true)

<br>
<h2>Área de Pruebas de TEN Agent en Entorno Local</h2>

### Prerrequisitos

| Categoría | Requisitos |
|----------|-------------|
| **Claves** | • Agora [ ID de App ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) y [ Certificado de App ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project)(minutos gratis cada mes) <br>• Clave API de [OpenAI](https://openai.com/index/openai-api/)<br>• ASR de [ Deepgram ](https://deepgram.com/) (créditos gratis disponibles al registrarse)<br>• TTS de [ FishAudio ](https://fish.audio/) (créditos gratis disponibles al registrarse)|
| **Instalación** | • [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/)<br>• [Node.js(LTS) v18](https://nodejs.org/en) |
| **Requisitos Mínimos del Sistema** | • CPU >= 2 Núcleos<br>• RAM >= 4 GB |

<br>

### macOS: Configuración de Docker en Apple Silicon

Para Mac con Apple Silicon, desmarque "Use Rosetta for x86/amd64 emulation" en la configuración de Docker. Nota: Esto puede resultar en tiempos de compilación más lentos en ARM, pero el rendimiento será normal cuando se despliegue en servidores x64.

![Configuración de Docker](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true)

<br>

### Siguiente paso

#### 1. Crear archivo `.env`

```bash
cp ./.env.example ./.env
```

#### 2. Configurar ID de App y Certificado de Agora en `.env`

```bash
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
```

#### 3. Iniciar contenedores de desarrollo del agente
```bash
docker compose up -d
```

#### 4. Entrar al contenedor
```bash
docker exec -it ten_agent_dev bash
```

#### 5. Construir agente 
```bash
task use
```

#### 6. Iniciar el servidor web
```bash
task run
```

#### 7. Editar configuración del área de pruebas
Abra el área de pruebas en [localhost:3000](http://localhost:3000) para configurar su agente.
 1. Seleccione un tipo de gráfico (ej. Agente de Voz, Agente en Tiempo Real)
 2. Elija un módulo correspondiente
 3. Seleccione una extensión y configure sus ajustes de clave API

![Ejemplo de Módulo](https://github.com/TEN-framework/docs/blob/main/assets/gif/module-example.gif?raw=true)

<br>
<h2>Componentes de TEN Agent</h2>

![Diagrama de Componentes](https://github.com/TEN-framework/docs/blob/main/assets/jpg/diagram.jpg?raw=true)

<br>
<h2>Mantente Atento</h2>

Antes de empezar, asegúrate de marcar con una estrella nuestro repositorio y recibir notificaciones instantáneas de todos los nuevos lanzamientos!

![GIF marca con estrella TEN](https://github.com/TEN-framework/docs/blob/main/assets/gif/star_us_2.gif?raw=true)

<br>

<h2>Únete a la Comunidad</h2>

- [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 retroalimentación y hacer preguntas.
- [Issues de GitHub](https://github.com/TEN-framework/ten-agent/issues): Mejor para reportar errores y proponer nuevas funcionalidades. Consulta nuestras [pautas de contribución](./docs/code-of-conduct/contributing.md) para más detalles.
- [X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5): Excelente para compartir tus agentes e interactuar con la comunidad.

<br>
<h2>Contribuidores de Código</h2>

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

<br>
<h2>Pautas de Contribución</h2>

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

<br>
<h2>Licencia</h2>

Este proyecto está licenciado bajo la Licencia Apache 2.0 - consulta el archivo [LICENSE](LICENSE) para más detalles.