Videosdk CLI

Install the VideoSDK CLI using python:

pip install videosdk-cli

---

Authentication

Login to your VideoSDK account:

videosdk auth

---

Project Management

List Projects

videosdk projects

Example output:

No.	Project Name	Created At	API Key	Status
1	CLI test	2025-10-10T09:43:55.693Z	4818f6da-fdda-45b3-8121-****	Active
2	New Project	2025-10-03T12:15:11.586Z	42706f4d-069c-4b47-b693-****	Active
3	Auto Generated	2025-09-23T06:53:50.625Z	ba04b195-c6fd-475d-b9cc-****	Active

Select a Project

? Select a project: Use ↑ ↓ to navigate, Enter to select
  CLI test (4818f6da-fdda-45b3-8121-****)
👉 New Project (42706f4d-069c-4b47-b693-****)
  Auto Generated (ba04b195-c6fd-475d-b9cc-****)

List all Templates

videosdk template list

Template Name	File Name	Description
ai-agent-cascading-pipeline	ai-agent-cascading-pipeline.py	AI Agent with a cascading, multi-provider pipeline.
ai-agent-real-time-pipeline	ai-agent-real-time-pipeline.py	AI Agent with a cascading, multi-provider pipeline.

---

Create and run your own agent

Created Agent

videosdk template get -t ai-agent-cascading-pipeline my-app

Here you will get templates that are preconfigured or custom. According to the template you will have to select providers and give API_KEYs

CLI will ask you if you have existing python environment that you want to use or if you want to make new one.

Once done you will need to be in parent directory of your agent folder ../my-app

Run the agent

videosdk run my-app

It will download necessary requirements and will run the agent inside console.

videosdk@videosdks-MacBook-Air cli_test % videosdk run my-app
Running project 'my-app'...
[✓] model_quantized.onnx already downloaded.
[✓] model_quantized.onnx already downloaded.
====================================================================================================
               Videosdk's AI Agent Console Mode
====================================================================================================
Session end callback configured
Waiting for participant...
Participant joined
2025-10-13 12:21:20,846 - INFO - agent output speech: Hello, how can I help you today?
Agent is running... (will exit automatically when participants leave)
[Audio] cBook Air Microphone [-41.31 dBFS] [############----------------------------]2025-10-13 12:21:28,109 - INFO - eou latency: 149.9921ms
2025-10-13 12:21:28,109 - INFO - user input speech: Hello?
2025-10-13 12:21:28,109 - INFO - stt latency: 2110.048ms
[Audio] cBook Air Microphone [-38.96 dBFS] [#####################-------------------]
2025-10-13 12:21:28,910 - INFO - llm latency: 798.5704ms
2025-10-13 12:21:29,114 - INFO - agent output speech: Hello! How can I assist you today?
2025-10-13 12:21:32,586 - INFO - agent output speech: Goodbye!