Home

Awesome

TEN Agent banner

<div align="center">

Follow on X Discussion posts Commits Issues closed PRs Welcome GitHub license

Discord TEN Community

<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>

GitHub watchers GitHub forks GitHub stars

<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>

Getting Started <span>  •  </span> Create Extensions <span>  •  </span> TEN Framework Repository

</div> <br> <h2>🌟 Gemini Multimodal Live API Extension with RTC</h2> <!-- ![Usecases](https://github.com/TEN-framework/docs/blob/main/assets/jpg/gemini-with-ten.jpg?raw=true) -->

Usecases

agent.theten.ai

Try Google Gemini Multimodal Live API with realtime vision and realtime screenshare detection capabilities, it is a ready-to-use extension, along with powerful tools like Weather Check and Web Search integrated perfectly into TEN Agent.

<br> <h2>TEN Agent Usecases</h2>

Usecases

<br> <h2>Ready-to-use Extensions</h2>

Ready-to-use Extensions

<br> <h2>TEN Agent Playground in Local Environment</h2>

Prerequisites

CategoryRequirements
Keys• Agora App ID and App Certificate (free minutes every month) <br>OpenAI API key<br> Deepgram ASR (free credits available with signup)<br> FishAudio TTS (free credits available with signup)
InstallationDocker / Docker Compose<br>Node.js(LTS) v18
Minimum System Requirements• CPU >= 2 Core<br>• RAM >= 4 GB
<br>

macOS: Docker setting on Apple Silicon

For Apple Silicon Macs, uncheck "Use Rosetta for x86/amd64 emulation" in Docker settings. Note: This may result in slower build times on ARM, but performance will be normal when deployed to x64 servers.

Docker Setting

<br>

Next step

1. Create .env file

cp ./.env.example ./.env

2. Setup Agora App ID and App Certificate in .env

AGORA_APP_ID=
AGORA_APP_CERTIFICATE=

3. Start agent development containers

docker compose up -d

4. Enter container

docker exec -it ten_agent_dev bash

5. Build agent

task use

6. Start the web server

task run

7. Edit playground settings

Open the playground at localhost:3000 to configure your agent.

  1. Select a graph type (e.g. Voice Agent, Realtime Agent)
  2. Choose a corresponding module
  3. Select an extension and configure its API key settings

Module Example

Running Gemini Realtime Extension

Open the playground at localhost:3000.

  1. Select voice_assistant_realtime graph
  2. Choose Gemini Realtime module
  3. Select v2v extension and enter Gemini API key

Gemini Realtime Playground

<br> <h2>TEN Agent Components</h2>

Components Diagram

<br> <h2>Stay Tuned</h2>

Before we get started, be sure to star our repository and get instant notifications for all new releases!

TEN star us gif

<br> <h2>Join Community</h2> <br> <h2>Star History</h2>

Star History Chart

<br> <h2>Code Contributors</h2>

TEN

<br> <h2>Contribution Guidelines</h2>

Contributions are welcome! Please read the contribution guidelines first.

<br> <h2>License</h2>

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.