TEN Agent is a conversational voice AI agent powered by TEN, integrating Deepseek, Gemini, OpenAI, RTC, and hardware like ESP32. It enables realtime AI capabilities like seeing, hearing, and speaking, and is fully compatible with platforms like Dify and Coze.
pip install ten-agent
✨ TEN Agent + Deepseek
TEN is a very versatile framework. That said, TEN Agent is compatible with DeepSeek R1, try experiencing realtime conversations with DeepSeek R1!
✨ TEN Agent + ESP32
TEN Agent is now running on the Espressif ESP32-S3 Korvo V3 development board, an excellent way to integrate realtime communication with LLM on hardware.
TEN Agent + Dify with RAG + Coze
TEN Agent + Dify Agent with RAG
TEN offers a great support to make the realtime interactive experience even better on other LLM platform as well, check out docs for more.
TEN Agent + Gemini Multimodal Live API
Gemini 2.0 Multimodal Live API
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.
TEN Agent + Storyteller + Image Generator
Storyteller + Image Generator
Describe a topic and ask TEN Agent to tell you a story while also generating images of the story to provide a more immersive experience for kids.
TEN Agent Usecases
Ready-to-use Extensions
TEN Agent Playground in Local Environment
Prerequisites
| Category | Requirements |
|---|---|
| Keys | • Agora App ID and App Certificate (free minutes every month) • OpenAI API key (any LLM that is compatible with OpenAI) • Deepgram ASR (free credits available with signup) • Elevenlabs TTS (free credits available with signup) |
| Installation | • Docker / Docker Compose • Node.js(LTS) v18 |
| Minimum System Requirements | • CPU >= 2 Core • RAM >= 4 GB |
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.
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.
- Select a graph type (e.g. Voice Agent, Realtime Agent)
- Choose a corresponding module
- Select an extension and configure its API key settings
Now, we have successfully set up the playground. This is just the beginning of TEN Agent. There are many different ways to explore and utilize TEN Agent. To learn more, please refer to the documentation.
Deployment
Once you have customized your agent (either by using the playground or editing property.json directly), you can deploy it by creating a release Docker image for your service.
Read the Deployment Guide for detailed information about deployment.
TEN Agent Architecture
Stay Tuned
Before we get started, be sure to star our repository and get instant notifications for all new releases!
Join Community
- Discord: Ideal for sharing your applications and engaging with the community.
- GitHub Discussion: Perfect for providing feedback and asking questions.
- GitHub Issues: Best for reporting bugs and proposing new features. Refer to our contribution guidelines for more details.
- X: Great for sharing your agents and interacting with the community.
Star History
Code Contributors
Contribution Guidelines
Contributions are welcome! Please read the contribution guidelines first.
License
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.