Repository files navigation

TEN is a comprehensive open-source ecosystem for creating, customizing, and deploying real-time conversational AI agents with multimodal capabilities including voice, vision, and avatar interactions.

TEN includesTEN Framework,TEN Turn Detection,TEN VAD,TEN Agent,TMAN Designer, andTEN Portal. Check out🌍 TEN Ecosystem for more details.

Community Channel	Purpose
	Follow TEN Framework on X for updates and announcements
	Follow TEN Framework on LinkedIn for updates and announcements
	Join our Discord community to connect with developers
	Join our Hugging Face community to explore our spaces and models
	Join our WeChat group for Chinese community discussions

Star History

TMAN Designer is a low/no-code option to create voice agents with an easy-to-use workflow UI. It can load apps and graphs, and includes an online editor, log viewer, and much more.

Check outthis blog for more details.

Build engaging AI avatars with TEN Agent usingTrulience's diverse collection of free avatar options. To get it up and running, you only need 2 steps:

1. Follow the README to finish setting up and running the Playground
2. Enter the avatar ID andtoken you get fromTrulience

TEN Agent now integrates seamlessly with MCP servers, expanding its LLM capabilities. To get started:

1. Open the Module Picker in Playground
2. Add the MCP server tool for LLM integration
3. Paste a URL from your MCP server in the extension
4. Start a realtime conversation with TEN Agent

This integration allows you to leverage MCP's diverse servers offerings while maintaining TEN Agent's powerful conversational abilities.

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.

Check out theintegration guide for more details.

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

TEN offers a great support to make the realtime interactive experience even better on other LLM platform as well, check out docs for more.

Experience the real-time image generation with StoryTeller, it is a ready-to-use extension, along with powerful tools like Weather Check and Web Search integrated perfectly into TEN.

cd ai_agentscp ./.env.example ./.env

AGORA_APP_ID=AGORA_APP_CERTIFICATE=

docker compose up -d

dockerexec -it ten_agent_dev bash

check the/examples folder for more examples

# use the default agenttask use# or use the demo agenttask use AGENT=agents/examples/demo

task run

1. Openlocalhost:49483.
2. Right click to load the corresponding graph (e.g., Voice Assistant).
3. Enter API keys and set preferences for each extension.
4. Right click and selectRun to start the agent.

GitHub offers free Codespace for each repository, you can run the playground in Codespace without using Docker.Also, the speed of Codespace is much faster than localhost.

Check outthis guide for more details.

Once you have customized your agent (either by using the TMAN Manager, Playground, or editingproperty.json directly), you can deploy it by creating a release Docker image for your service.

Read theDeployment Guide for detailed information about deployment.

coming soon

Project	Preview
🏚️ TEN Framework TEN is an open-source framework for real-time, multimodal conversational AI.
️🔂 TEN Turn Detection TEN is for full-duplex dialogue communication.
🔉 TEN VAD TEN VAD is a low-latency, lightweight and high-performance streaming voice activity detector (VAD).
🎙️ TEN Agent TEN Agent is a showcase of TEN Framewrok.
🎨 TMAN Designer TMAN Designer is low/no code option to make a voice agent with easy to use workflow UI.
📒 TEN Portal The official site of TEN framework, it has documentation and blog.

Most questions can be answered by using DeepWiki, it is fast, intutive to use and supports multiple languages.

We welcome all forms of open-source collaboration! Whether you're fixing bugs, adding features, improving documentation, or sharing ideas - your contributions help advance personalized AI tools. Check out our GitHub Issues and Projects to find ways to contribute and show your skills. Together, we can build something amazing!

Contributions are welcome! Please read thecontribution guidelines first.

1. The entire TEN framework (except for the folders explicitly listed below) is released under the Apache License, Version 2.0, with additional restrictions. For details, please refer to theLICENSE file located in the root directory of the TEN framework.

2. The components within thepackages directory are released under the Apache License, Version 2.0. For details, please refer to theLICENSE file located in each package's root directory.

3. The third-party libraries used by the TEN framework are listed and described in detail. For more information, please refer to thethird_party folder.