TEN Framework
Open-source framework for realtime multimodal conversational agents backed by Agora, with a visual graph designer (TMAN Designer), agent examples, and the TEN VAD and TEN Turn Detection models.
Overview
Best for: Teams on Agora who want to self-host and customise the same stack Agora's engine is built on, or who need the TEN VAD/turn models.
At a glance
Open source (Apache 2.0 with additional restrictions). Turn detection model covers English and Chinese only. Visual graph designer (TMAN). SIP via example extension, no numbers.
Agora RTC by default; other extensions possible
Same
Depends on providers; turn detection supports English and Chinese.
No verified number.
Self-hosted.
N/A (self-hosted).
Features
- visual graph designer
- turn detection
- VAD
- multi-provider plug-ins (extensions)
- avatars
- SIP call example
Pricing
| What | Price | Unit |
|---|---|---|
| Framework | $0 | license |
Depends entirely on chosen transport and providers; no vendor figure.
Free tier: Open source.
Source: github.com
Setup
- Clone github.com/TEN-framework/ten-framework and follow the ai_agents README (Docker, Node.js 18 prerequisite).
- Fill in .env with Agora App ID and provider keys.
- Start the dev stack, open TMAN Designer at localhost:49483, pick an example graph (voice assistant, SIP call) and edit extension properties.
Endpoint
Self-hosted
Authentication
Provider keys in .env
Quick start python
# TEN is configured as a graph (JSON) of extensions rather than a short script.
# Start from an example in the repo:
# git clone https://github.com/TEN-framework/ten-framework
# cd ten-framework/ai_agents # follow README: copy .env.example to .env, add keys
# # start the dev containers as the README describes, then open
# # http://localhost:49483 (TMAN Designer) and select the voice-assistant graph
Written from the current docs. Check the vendor's SDK version before you ship.
Warnings
License has extra restrictions
Both the framework and the turn-detection model are 'Apache 2.0 with additional restrictions'. Read LICENSE before commercial use.
Smaller ecosystem
Fewer integrations, docs and community answers than Pipecat or LiveKit Agents.
No managed hosting from the project
Hosted use is via Agora's Conversational AI Engine (priced separately).
Releases not clearly versioned
The GitHub releases section was empty when checked; pin a commit.
Plus 12 warnings that apply to all platforms and telephony APIs. See category warnings.
Limits
- You operate everything: scaling, monitoring, TURN
Models and products
| Name | Status |
|---|---|
| TEN Framework | GA |
| TEN VAD | GA |
| TEN Turn Detection | GA |
Docs and sources
Docs
Sources used
- github.com/TEN-framework/ten-framework
- agora.io/en/open-source/ten-framework
- github.com/TEN-framework/ten-turn-detection
- agora.io/en/blog/making-voice-ai-agents-more-human-with-ten-vad-and-turn-detect...
Exact startup commands (README changes often); latest version.