Skip to main content
Conversational AI Engine: Create advanced voice apps by combining Agora’s real-time audio with powerful conversational AI.

Run the demo

This guide shows you how to run the TEN Agent demo, a web-based interface for interacting with the agent. The demo uses a fixed orchestration that demonstrates the agent's capabilities including:

  • Real-time voice interaction
  • Multi-modal communication
  • Extension orchestration
  • Agent response handling

Prerequisites​

Before running the demo:

  • Complete the Agent quickstart
  • Ensure Docker is running on your system
  • Install pnpm if you want to run from source code

Run from Docker image​

The quickest way to run the demo is using the pre-built Docker image included in the project.

  1. Follow the Agent quickstart to set up the environment

  2. Switch to the demo configuration:


    _1
    task use AGENT=agents/examples/demo

  3. Start the web server:


    _1
    task run

  4. Access the demo at http://localhost:3002

Run from source code​

To run the demo from source code:

  1. Open a new terminal in the TEN-Agent project directory

  2. Navigate to the demo folder:


    _1
    cd demo

  3. Install dependencies:


    _1
    pnpm install

  4. Start the demo:


    _1
    pnpm dev

  5. Access the demo at http://localhost:3001

info

The demo requires the Go web server to be running. Start it with task run in the container after completing the Getting started guide.