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

<div align="center">

[![Suivre sur X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5)](https://twitter.com/intent/follow?screen_name=TenFramework)
[![Messages de discussion](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)
[![Problèmes résolus](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 Bienvenues](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/TEN-framework/ten-agent/pulls)
[![Licence 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 Communauté 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>

[![Observateurs 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)
[![Étoiles 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 en Anglais" 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 en 한국어" 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 en Italien" src="https://img.shields.io/badge/Italiano-lightgrey"></a>

[Commencer](https://doc.theten.ai/ten-agent/getting_started)
<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
[Créer des Extensions](https://doc.theten.ai/ten-agent/create_a_hello_world_extension)
<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
[Dépôt TEN Framework](https://github.com/TEN-framework/ten_framework)

</div>

<br>
<h2>🎉 TEN Agent avec l'API Temps Réel OpenAI et RTC</h2>

Essayez l'API Temps Réel OpenAI, la **Vérification Météo** et la **Recherche Web** sur [agent.theten.ai](https://agent.theten.ai).

En combinant l'API Temps Réel OpenAI pour une latence ultra-faible avec la suppression du bruit AI de RTC, nous assurons des interactions fluides et de haute qualité. De plus, l'intégration transparente des outils météo et d'actualités rend TEN Agent encore plus polyvalent.

![TEN Agent avec l'API Temps Réel OpenAI et RTC](https://github.com/TEN-framework/docs/blob/main/assets/gif/weather-and-news.gif?raw=true)

<br>
<h2>Cas d'Utilisation de TEN Agent</h2>

![Cas d'utilisation](https://github.com/TEN-framework/docs/blob/main/assets/jpg/usecases.jpg?raw=true)

<br>
<h2>Extensions Prêtes à l'Emploi</h2>

![Extensions Prêtes à l'Emploi](https://github.com/TEN-framework/docs/blob/main/assets/jpg/extensions.jpg?raw=true)

<br>
<h2>Environnement Local TEN Agent Playground</h2>

### Prérequis

| Catégorie | Exigences |
|----------|-------------|
| **Clés** | • Agora [ ID App ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project) et [ Certificat App ](https://docs.agora.io/en/video-calling/get-started/manage-agora-account?platform=web#create-an-agora-project)(minutes gratuites chaque mois) <br>• Clé API [OpenAI](https://openai.com/index/openai-api/)<br>• [ Deepgram ](https://deepgram.com/) ASR (crédits gratuits disponibles à l'inscription)<br>• [ FishAudio ](https://fish.audio/) TTS (crédits gratuits disponibles à l'inscription)|
| **Installation** | • [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/)<br>• [Node.js(LTS) v18](https://nodejs.org/en) |
| **Configuration Système Minimale** | • CPU >= 2 Cœurs<br>• RAM >= 4 Go |

<br>

### macOS : Configuration Docker sur Apple Silicon

Pour les Mac Apple Silicon, décochez "Use Rosetta for x86/amd64 emulation" dans les paramètres Docker. Note : Cela peut ralentir les temps de compilation sur ARM, mais les performances seront normales lors du déploiement sur des serveurs x64.

![Paramètres Docker](https://github.com/TEN-framework/docs/blob/main/assets/gif/docker_setting.gif?raw=true)

<br>

### Étapes suivantes

#### 1. Créer le fichier `.env`

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

#### 2. Configurer l'ID App et le Certificat App Agora dans `.env`

```bash
AGORA_APP_ID=
AGORA_APP_CERTIFICATE=
```

#### 3. Démarrer les conteneurs de développement de l'agent
```bash
docker compose up -d
```

#### 4. Entrer dans le conteneur
```bash
docker exec -it ten_agent_dev bash
```

#### 5. Construire l'agent 
```bash
task use
```

#### 6. Démarrer le serveur web
```bash
task run
```

#### 7. Modifier les paramètres du playground
Ouvrez le playground sur [localhost:3000](http://localhost:3000) pour configurer votre agent.
 1. Sélectionnez un type de graphe (ex. Agent Vocal, Agent Temps Réel)
 2. Choisissez un module correspondant
 3. Sélectionnez une extension et configurez ses paramètres de clé API

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

<br>
<h2>Composants TEN Agent</h2>

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

<br>
<h2>Restez à l'Écoute</h2>

Avant de commencer, n'oubliez pas de mettre une étoile à notre dépôt pour recevoir des notifications instantanées de toutes les nouvelles versions !

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

<br>

<h2>Rejoindre la Communauté</h2>

- [Discord](https://discord.gg/VnPftUzAMJ) : Idéal pour partager vos applications et interagir avec la communauté.
- [Discussion GitHub](https://github.com/TEN-framework/ten-agent/discussions) : Parfait pour fournir des retours et poser des questions.
- [Problèmes GitHub](https://github.com/TEN-framework/ten-agent/issues) : Idéal pour signaler des bugs et proposer de nouvelles fonctionnalités. Consultez nos [directives de contribution](./docs/code-of-conduct/contributing.md) pour plus de détails.
- [X](https://img.shields.io/twitter/follow/TenFramework?logo=X&color=%20%23f5f5f5) : Excellent pour partager vos agents et interagir avec la communauté.

<br>
<h2>Contributeurs au Code</h2>

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

<br>
<h2>Directives de Contribution</h2>

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

<br>
<h2>Licence</h2>

Ce projet est sous licence Apache 2.0 - voir le fichier [LICENSE](LICENSE) pour plus de détails.