Skip to main content

Console Mode for AI Agents

Console mode allows you to interact with your AI agent directly through the terminal without joining a VideoSDK meeting room. This is particularly useful for:

  • Quick testing of agent functionality
  • Local development and debugging
  • Testing function tools and MCP integrations
  • Validating pipeline configurations

How It Works

When running your agent script in console mode:

  1. The agent runs in a terminal-based environment
  2. Your microphone input is captured directly through the terminal
  3. Agent responses are played through your system audio 4.Run the full Cascading Pipeline and RealTime Pipeline locally without connecting to a meeting. This makes it easier to verify that audio flows, agent logic, and response generation are working correctly before deploying into a live session.
  4. Function tools, MCP integrations, and other features remain fully functional

Using Console Mode

To use console mode, simply add the console argument when running your agent script:

python main.py console

The console will display:

  • Agent speech output
  • User speech input
  • Various latency metrics (STT, TTS, LLM,EOU)
  • Pipeline processing information

This flexibility allows you to use the same agent code for both development and production environments.

Got a Question? Ask us on discord